本页目录
官方资料整理 Windows Linux macOS

Three.js 开发与测试环境部署

用 Node.js 与 Vite/原生 ES Module 跑通 Three.js 示例,并打开现有前端游戏工程。

适用项目: 引擎通用(暂未关联具体项目)

工具版本:Node.js 20 LTS、three (npm)

未标注「站长实测」的步骤请自行核验。

本篇为 Three.js 通用环境教程。官方手册:threejs.org/docs。浏览器游戏多为前端工程,关键是 本地静态服务器 + 正确的模块加载,不要直接用 file:// 打开复杂示例。

1. 安装 Node.js

  1. 安装 Node.js LTS。
  2. 验证:
node -v
npm -v

可选:启用 corepack / 使用项目锁定的包管理器(npm、pnpm、yarn)。

2. 最小 Vite + three 验证(推荐)

npm create vite@latest three-smoke -- --template vanilla
cd three-smoke
npm install
npm install three
npm run dev

在入口脚本中 import * as THREE from 'three',创建 WebGLRenderer 与旋转立方体;浏览器打开终端提示的本地地址,能看到画面即环境正常。

3. 运行开源 Three.js 项目

  1. 克隆后执行锁文件对应的安装:npm ci / pnpm i / yarn。
  2. 使用 README 中的 dev / start 脚本;构建用 build。
  3. 注意 three 大版本与示例代码 API(如 THREE.Geometry 已移除)是否匹配。
  4. 官方示例仓库也可作对照:mrdoob/three.js/examples