Three.js 教程
Three.js 是一个基于 JavaScript 的开源 3D 图形库,可以帮助我们在网页中创建和展示三维场景、模型与动画。
借助 Three.js,我们可以用 JavaScript 创建立方体、球体、灯光和摄像机,也可以导入外部 3D 模型,制作可以旋转、缩放和交互的网页内容。
Three.js 对 WebGL 等底层图形能力进行了封装,让我们不必从零编写复杂的图形渲染代码,也能逐步开发 3D 网站、产品展示、互动动画和简单的浏览器游戏。
什么是 Three.js
Three.js 是运行在浏览器中的 JavaScript 3D 图形库。它并不是一款独立的三维建模软件,而是让我们通过代码将 3D 内容展示在网页上的开发工具。
例如,普通网页通常由文字、图片和二维布局组成,而使用 Three.js 后,我们还可以让访客拖动一个产品模型、环绕观察建筑,或者观看具有立体空间感的动画。
我们可以把 Three.js 的工作方式简单理解为:准备场景中的物体 → 放置摄像机 → 交给渲染器绘制到网页中。
| 核心概念 | 作用 | 简单理解 |
|---|---|---|
Scene(场景) | 保存需要显示的物体、灯光等对象 | 舞台 |
Camera(相机) | 决定从哪个位置、哪个角度观察 | 摄影机 |
Renderer(渲染器) | 把场景画到网页的 Canvas 中 | 画面输出设备 |
Geometry(几何体) | 定义物体形状 | 模型骨架 |
Material(材质) | 定义物体表面如何呈现 | 外观和表面属性 |
Mesh(网格对象) | 组合几何体和材质 | 可以放到舞台上的物体 |
Three.js 可以做什么
Three.js 很适合为现有网页加入 3D 内容。常见应用包括:
- 3D 产品展示:让我们旋转、缩放和查看鞋子、家具、电子产品等模型。
- 网页互动动画:制作粒子、形状变换、空间转场和交互效果。
- 数据可视化:通过立体图形表现空间数据、位置关系和复杂结构。
- 浏览器游戏:实现简单 3D 场景、角色移动和交互操作。
- 建筑与场景预览:展示房间、建筑或展厅的三维布局。
- 模型查看器:通过
GLTFLoader等工具加载 glTF/GLB 模型。
如果我们的项目只是普通表单和文字页面,并不一定需要引入 3D;当需要展示空间关系、模型或具有深度感的交互时,Three.js 才更能发挥优势。
学习 Three.js 前需要掌握什么
在阅读本教程前,建议我们先了解:
- HTML:知道如何创建网页和页面容器。
- CSS:能够设置页面尺寸、布局与背景。
- JavaScript:理解变量、函数、对象和事件。
- ES Modules:认识
import和<script type="module">的基本用法。
我们暂时不必掌握矩阵运算、着色器编程或专业建模。第一阶段先能看懂和修改一个 3D 场景,再逐步学习进阶内容。
Three.js 安装与引入
Three.js 主要有两种常见使用方式:通过 npm 安装到前端项目,或者使用 CDN 和 Import Map 在普通 HTML 页面中引入。
使用 npm 安装
如果我们使用 Vite、Vue 或其他现代前端开发环境,可以执行:
npm install three
随后在 JavaScript 模块中使用:
import * as THREE from 'three';
通过 CDN 引入
Three.js 可以通过 CDN 直接引入,无需安装 Node.js 或构建工具。
如果只想快速学习,我们可以直接创建一个 HTML 文件,通过 importmap 指定 Three.js 的模块地址。
| CDN | 引入地址 |
|---|---|
| jsDelivr | https://cdn.jsdelivr.net/npm/three@0.187.0/build/three.module.js |
| Cloudflare cdnjs | https://cdnjs.cloudflare.com/ajax/libs/three.js/0.187.0/three.module.js |
| UNPKG | https://unpkg.com/three@0.187.0/build/three.module.js |
| esm.sh | https://esm.sh/three@0.187.0 |
我们可以使用 Import Map 指定 Three.js 的加载地址:
<script type="importmap">
{
"imports": {
"three": "https://cdn.jsdelivr.net/npm/three@0.187.0/build/three.module.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/three@0.187.0/examples/jsm/"
}
}
</script>
<script type="module">
import * as THREE from 'three';
const scene = new THREE.Scene();
console.log(scene);
</script>
第一个 Three.js 实例
我们先在网页中创建一个可以自动旋转的蓝色立方体。这是理解 Three.js 最直观的入门练习。
Three.js 实例:旋转的立方体
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Three.js 第一个实例</title>
<style>
body { margin: 0; background: #f3f6fa; }
#scene { width: 100%; height: 420px; }
</style>
<script type="importmap">
{
"imports": {
"three": "https://static.jyshare.com/assets/libs/threejs/three-0.187.0/build/three.module.js"
}
}
</script>
</head>
<body>
<div id="scene"></div>
<script type="module">
import * as THREE from 'three';
const container = document.getElementById('scene');
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf3f6fa);
const camera = new THREE.PerspectiveCamera(75, 1, 0.1, 100);
camera.position.z = 4;
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
container.appendChild(renderer.domElement);
const geometry = new THREE.BoxGeometry(1.6, 1.6, 1.6);
const material = new THREE.MeshNormalMaterial();
const cube = new THREE.Mesh(geometry, material);
scene.add(cube);
function resize() {
const width = container.clientWidth;
const height = container.clientHeight;
camera.aspect = width / height;
camera.updateProjectionMatrix();
renderer.setSize(width, height);
}
window.addEventListener('resize', resize);
resize();
renderer.setAnimationLoop((time) => {
cube.rotation.x = time * 0.0005;
cube.rotation.y = time * 0.001;
renderer.render(scene, camera);
});
</script>
</body>
</html>
尝试一下 »
点击 "尝试一下" 按钮查看在线实例
保存为 index.html,通过本地 HTTP 服务打开后,就可以看到一个不断旋转的立方体。
为了避免 ES Modules 在本地 file:// 环境下受到浏览器安全限制,建议我们在该文件所在目录运行:
python -m http.server 8000
然后访问 http://localhost:8000/。如果电脑里没有 Python,也可以使用编辑器的本地服务器功能。
这段代码的完整版本可作为独立 HTML 文件运行;在 WordPress 文章中,我们使用代码高亮框展示源码,不直接把模块脚本插入文章正文执行。
第一个实例的代码解析
这个立方体虽然简单,但已经包含了 Three.js 最常用的几个基础对象。
| 代码 | 说明 |
|---|---|
new THREE.Scene() | 创建三维场景 |
new THREE.PerspectiveCamera() | 创建透视相机 |
new THREE.WebGLRenderer() | 创建 WebGL 渲染器 |
new THREE.BoxGeometry() | 创建立方体几何形状 |
new THREE.MeshNormalMaterial() | 使用法线方向呈现不同颜色 |
new THREE.Mesh() | 将几何体与材质组合成物体 |
scene.add(cube) | 把立方体添加到场景 |
renderer.setAnimationLoop() | 设置动画渲染循环 |
Scene:创建场景
我们可以把 Scene 看作一间虚拟摄影棚。场景中可以摆放模型、灯光和其他三维对象。
Camera:确定观察角度
相机决定我们从哪个位置观察场景。示例通过 camera.position.z = 4 把相机向后移动,避免相机位于立方体内部。
Geometry、Material 与 Mesh
Geometry 定义形状,Material 决定表面如何显示,Mesh 则将二者组合成可放入场景的三维对象。
Renderer:把三维场景画出来
渲染器负责将场景从相机视角绘制到 Canvas。只创建对象并不会自动在网页上显示,还需要调用 renderer.render(scene, camera)。
动画循环
通过 renderer.setAnimationLoop(),我们可以持续更新物体旋转角度并重新渲染。示例中的 time 为时间戳,因此能够让立方体随时间转动,而不是依赖某个固定帧率。
Three.js 的特点与优势
- 面向 Web 的三维图形:通过 JavaScript 在浏览器中渲染交互式 3D 场景。
- 核心对象清晰:使用场景、相机、几何体、材质和渲染器组织三维内容。
- 支持动画与交互:可以为对象添加旋转、移动、鼠标选择与触控操作。
- 模型与资源加载:支持使用附加加载器导入 glTF/GLB 等常见三维资源。
- 灯光和材质系统:可以制作更真实的材质、阴影和光照效果。
- 与现有网页集成:可以把 3D Canvas 放进普通网页、Vue 或 React 应用。
- 生态丰富:提供
OrbitControls、GLTFLoader和后期处理等 addons。 - 可按需扩展:从简单几何体起步,再逐渐引入复杂模型与渲染效果。
需要注意,3D 场景的性能与模型面数、材质、灯光、设备 GPU 和渲染分辨率等因素有关。Three.js 简化了 3D 开发,但不意味着所有场景都会自动保持高帧率。
Three.js 与 WebGL、WebGPU 的关系
刚接触 Three.js 时,我们可能会把它和 WebGL、WebGPU 混在一起。
| 技术 | 作用 | 适合谁 |
|---|---|---|
| WebGL | 浏览器提供的底层图形绘制 API | 需要直接控制图形渲染的开发者 |
| WebGPU | 面向现代 GPU 图形与计算的新一代 Web API | 需要现代图形或 GPU 计算能力的应用 |
| Three.js | 封装三维场景、模型、材质与渲染工作流 | 希望更方便构建 Web 3D 应用的开发者 |
我们在第一阶段可以先使用 WebGLRenderer,掌握场景、对象和动画。Three.js 也提供 WebGPU 相关渲染支持,具体能力与浏览器兼容性应参考官方文档。
Three.js 学习路线
如果我们准备系统学习 Three.js,可以按照下面的顺序逐步练习:
| 学习阶段 | 主要内容 | 练习项目 |
|---|---|---|
| 基础入门 | Scene、Camera、Renderer、Mesh | 旋转的立方体 |
| 几何体与材质 | BoxGeometry、SphereGeometry、常见材质 | 制作简单几何体展台 |
| 光照与阴影 | 环境光、方向光、阴影 | 带灯光的三维物体 |
| 动画与控制 | 动画循环、OrbitControls、事件 | 可拖动旋转的 3D 模型 |
| 模型加载 | GLTFLoader、纹理、外部资源 | GLB 产品展示器 |
| 综合实战 | 性能优化、响应式布局、交互设计 | 在线 3D 展厅 |
本章节我们先完成第一个立方体实例。接下来可以尝试把立方体换成球体、修改材质,再加入 OrbitControls,让鼠标也能控制观察角度。
参考资料
官方网站:https://threejs.org/
官方文档:https://threejs.org/docs/
官方入门手册:https://threejs.org/manual/
场景创建教程:https://threejs.org/manual/pages/creating-a-scene.html
GitHub 源码:https://github.com/mrdoob/three.js
