现在位置: 首页 > Three.js 教程 > 正文

Three.js 教程

Three.js 3D 图形教程图标

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 实例:旋转的立方体

<!DOCTYPE html>
<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