Three.js 简介
在浏览器里看到一个能旋转、发光、带阴影的 3D 模型时,多数人的第一反应是觉得这一定很难。这一章先拆掉这层神秘感:搞清楚网页 3D 的底层原理、Three.js 在其中扮演什么角色、它能用来做什么,以及 AI 大模型给这个领域带来的变化。
看完这一章,你不需要写任何代码,但后面所有章节的决策(选哪个渲染器、什么时候交给 AI、学到什么程度算够)都建立在这几个问题的答案上。
网页里的 3D 是怎么画出来的
浏览器自己不会画 3D,真正干活的是显卡(GPU)。浏览器负责把 GPU 的能力开放给网页,这个接口经历了两代:
| 接口 | 推出时间 | 现状 |
|---|---|---|
| WebGL 2.0 | 2017 年标准化 | 当前所有主流浏览器都支持,是今天 3D 应用的基本盘 |
| WebGPU | 2023 年起陆续落地 | 新一代接口,性能更强,还支持 GPU 通用计算,但老浏览器不支持 |
而 WebGL 的第一代(WebGL 1.0)已于 2024 年被 Three.js 在 r163 版本中正式移除支持——这是很多老教程和 AI 生成代码踩坑的地方,后面讲版本问题时还会反复提到。
问题在于,WebGL/WebGPU 是一张非常底层的接口。不借助任何库,直接用 WebGL 在网页上画出一个三角形,你需要手写顶点着色器、片元着色器、顶点缓冲区、矩阵变换,一百多行代码起步;画一个带光照和阴影的立方体,代码量轻松突破五百行,而且全是没有类型检查的字符串拼出来的 GPU 程序。
Three.js 做的事情,就是把这张底层接口包装成人话:
| 你面对的概念 | 它替你包办的底层工作 |
|---|---|
| Scene(场景) | 管理所有物体的层级关系 |
| Mesh + Geometry + Material | 顶点缓冲区、着色器编译、光照计算 |
| Light(灯光) | 着色器里的光照模型与阴影贴图 |
| Camera(相机) | 投影矩阵、视锥体剔除 |
| Renderer(渲染器) | 渲染循环、GPU 资源管理、画布交互 |
同一个带光照的旋转立方体,用 Three.js 大约三十行就能跑起来,而且每一行都是可读的对象操作,不是着色器黑魔法。这就是它从 2010 年发布至今成为最流行网页 3D 库的原因:把 3D 开发的门槛从图形学工程师降到了会 JS 的前端。
整条技术栈的分层关系如下图:

你写的代码调用 Three.js,Three.js 调用浏览器的 WebGL2/WebGPU 接口,浏览器再驱动 GPU 渲染。本教程写作时的 Three.js 版本是 r187(0.187.0),全程以该版本的官方文档为准——这一点很重要,因为网上和 AI 生成代码中大量 API 是十年前旧版本的写法,直接复制往往跑不起来。
Three.js 能做什么
产品展示与电商:商品 360° 查看、可换色换材质的定制预览、家具放进自己客厅的 AR 预览。加载一个 glTF 模型加几个交互控件,就是这类页面的全部核心。
数据可视化:3D 地球、城市级数据大屏、园区与楼宇的数字孪生。把抽象数据放进三维空间后,哪栋楼能耗异常这类问题一眼可见。
品牌官网与活动页:滚动驱动的叙事页面、节日活动的小 3D 交互。这类页面追求视觉冲击,是很多前端接触 Three.js 的起点。
轻量游戏与互动内容:网页小游戏、虚拟展厅、在线博物馆。配合物理引擎和音频 API,完整玩法都能在浏览器里实现。
AI 应用的 3D 载体:这是近几年新增的一类。AI 数字人、对话式场景编辑器、手势控制交互,都需要一个 3D 渲染层来呈现——Three.js 是这个层的主流选择,本教程第五部分会专门展开。
和其他方案怎么选
Three.js 不是唯一选择,把常见方案放在一张表里对比:
| 方案 | 定位 | 上手难度 | 适合场景 |
|---|---|---|---|
| 原生 WebGL/WebGPU | 浏览器底层图形接口 | 很高 | 图形学学习、极致定制的渲染引擎 |
| Three.js | 通用 3D 场景库,生态最大 | 中 | 本表下面列出的绝大多数场景 |
| Babylon.js | 微软维护的完整游戏引擎 | 中 | 偏游戏玩法、想要引擎级全家桶(物理、音频、GUI 内置)的团队 |
| Cesium | 地理信息专用引擎 | 中高 | 地图、卫星影像、城市级 GIS 应用 |
| <model-viewer> | Google 出的零代码模型标签 | 极低 | 只需要展示一个能旋转的 glTF 模型,写一行 HTML 即可 |
选型逻辑不复杂:需求只是转个模型用 <model-viewer>;做地理用 Cesium;要完整游戏引擎就评估 Babylon.js;剩下的场景——自定义交互、粒子特效、着色器、AI 集成——Three.js 的生态(十余万个官方示例衍生方案、海量教程)都是最优解。它的 API 自由度也最高,代价是很多事要自己组装,这正是需要一本教程的原因。
AI 如何改变 3D 开发
Three.js 的知识体系有个传统痛点:概念多(几何、材质、光照、相机、着色器各成体系)、版本迭代快(几乎每月一个版本,API 说移除就移除)、效果难想象(不跑起来不知道长什么样)。这三点恰好分别是 AI 的强项、弱项和弱项。
所以本教程把 AI 的角色分成两条清晰的线:
主线 A:用 AI 辅助学 Three.js、写 Three.js。让 AI 生成场景代码、解释着色器、排查报错。这条线的核心技能不是会不会用 AI,而是能不能审查 AI 的产出——AI 写 Three.js 代码的幻觉率明显高于普通前端代码,它会自信地使用十年前就删除的 API。第 4 章开始系统训练这个能力。
主线 B:在 Three.js 应用里集成 AI 能力。让大模型通过工具调用直接操作 3D 场景,比如把一个立方体变红、加载 AI 生成的 3D 模型、接入摄像头手势识别、做带口型同步的 AI 数字人。这部分是第五部分的主角。
两条线贯穿全教程:核心章节(第二到第四部分)末尾都设有AI 实践小节,边学基础边练 AI 协作;学完基础后,第五部分再把两条线合并成完整的 AI + 3D 应用。
