本页目录
官方资料整理
Windows
Linux
macOS
Three.js 开发与测试环境部署
用 Node.js 与 Vite/原生 ES Module 跑通 Three.js 示例,并打开现有前端游戏工程。
本篇为 Three.js 通用环境教程。官方手册:threejs.org/docs。浏览器游戏多为前端工程,关键是 本地静态服务器 + 正确的模块加载,不要直接用 file:// 打开复杂示例。
1. 安装 Node.js
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 项目
- 克隆后执行锁文件对应的安装:
npm ci/pnpm i/yarn。 - 使用 README 中的
dev/start脚本;构建用build。 - 注意
three大版本与示例代码 API(如THREE.Geometry已移除)是否匹配。 - 官方示例仓库也可作对照:mrdoob/three.js/examples