- 协议
- MIT
- Star 数
- 约 11.9 万(118,770)
- 最新版本
- r187(npm 包 0.187.0,2026-10-30 发布)
- 运行环境
- 支持 WebGL 2 的现代浏览器(新版也可用 WebGPU 渲染);不依赖 Node.js,用打包工具时需 Node.js
Star 数、版本等数据截至 2026 年 11 月。 技术栈:JavaScriptWebGLWebGPU
定位
一句话:网页 3D 的事实标准:几十行代码画出可交互的 3D 场景。
Three.js 把 WebGL(以及新的 WebGPU)这层很底层的图形接口,包装成"场景、相机、网格、材质、灯光"这些好理解的概念,几十行 JavaScript 就能在网页里画出可交互的 3D 画面。它本身只是一个库、不规定页面怎么组织,因此能放进任何前端项目里;React Three Fiber、A-Frame 等上层框架也都建在它之上。官网首页直接是一面用户作品墙,从品牌官网、数据可视化到网页游戏,几乎所有"网页里的 3D"都能在这里找到参照。
仓库链接
- 仓库:https://github.com/mrdoob/three.js
- 官网:https://threejs.org/
- 文档:https://threejs.org/docs/
- 中文入门手册:https://threejs.org/manual/#zh/creating-a-scene
- 官方示例库:https://threejs.org/examples/
- 官方作品展示:https://threejs.org/(首页作品墙)
适用场景
- 适合:品牌官网与产品发布页的 3D 展示、商品 3D 预览与配置器、数据与地理可视化、网页小游戏、创意互动与作品集网站。
- 也能做:借助 WebXR 做浏览器里的 VR/AR;配合 React Three Fiber 在 React 项目里用组件的方式写 3D。
- 不太适合:大型 3D 游戏(缺少物理、关卡编辑等完整引擎能力,可选 Babylon.js、PlayCanvas 或原生引擎);只想在页面里放一个可转动的模型,用 Google 的
<model-viewer>更省事。
上手示例
用 Vite 建一个空项目,再装上 Three.js:
npm create vite@latest my-3d -- --template vanilla
cd my-3d
npm install three
npm run dev把 main.js 换成下面的代码,就能看到一个不停旋转的彩色立方体:
import * as THREE from 'three';
const scene = new THREE.Scene();
const camera = new THREE.PerspectiveCamera(75, innerWidth / innerHeight, 0.1, 100);
camera.position.z = 3;
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(innerWidth, innerHeight);
document.body.appendChild(renderer.domElement);
const cube = new THREE.Mesh(new THREE.BoxGeometry(1, 1, 1), new THREE.MeshNormalMaterial());
scene.add(cube);
renderer.setAnimationLoop((time) => {
cube.rotation.x = time / 2000;
cube.rotation.y = time / 1000;
renderer.render(scene, camera);
});这段代码依次建了场景(scene)、透视相机(camera)和渲染器(renderer),再把一个"立方体几何 + 法线材质"组成的网格放进场景;setAnimationLoop 每一帧调整立方体的角度并重新渲染,于是它就转起来了。
优点
- 上手快:概念直观、示例极多,几十行代码就能出效果,大量教程与问答可查。
- 生态最大:网页 3D 领域使用最广,React Three Fiber、各种加载器、后期特效、物理库都围绕它展开,遇到问题基本都能找到先例。
- 轻量灵活:只是一个库,不绑定任何前端框架或构建方式,可以按需引入。
- 紧跟新技术:持续更新,已提供 WebGPU 渲染器和新的着色语言 TSL,同时支持 WebXR。
- 协议宽松:MIT 协议,商业项目随意使用。
缺点
- 不承诺稳定的版本号:按 r1xx 每月左右发一版,常有不兼容的改动,升级前要看迁移说明。
- 不是完整的游戏引擎:没有内置物理、编辑器、资源管线,做大项目要自己拼装很多部分。
- 性能要自己操心:模型面数、贴图大小、绘制次数都会直接影响帧率,移动端尤其明显。
- 3D 基础门槛:想做出好效果,仍需要了解相机、光照、材质、着色器等图形学知识。
同类对比
| 框架 | 更适合 |
|---|---|
| Babylon.js | 想要更"全家桶"的引擎:自带物理、编辑器、检查器,适合 3D 游戏与工业应用 |
| PlayCanvas | 团队协作做网页游戏,有在线可视化编辑器 |
| React Three Fiber | 已在用 React,想用组件方式写 Three.js 场景 |
延伸阅读
- 官方入门手册(中文):https://threejs.org/manual/#zh/creating-a-scene
- 官方示例库:https://threejs.org/examples/
- Three.js Journey 课程:https://threejs-journey.xyz/
作品展示
官方示例库里有数百个可以直接在浏览器里运行的示例,首页作品墙收录了大量用户作品。下面挑两个官方示例和四个知名作品。
官方示例加载一个带关键帧动画的完整 3D 街景模型,可以用鼠标旋转、缩放查看细节,展示了 Three.js 处理复杂模型和动画的能力。
官方示例加载 glTF 格式的头盔模型,配合环境贴图做出金属与玻璃的真实反光,可在右上角切换模型和背景模糊度。
作品展示NASA 喷气推进实验室做的实时太阳系,行星与探测器按真实轨道运行,可以拖动时间轴、跟随任意航天器,是科普可视化的标杆。
作品展示开发者 Bruno Simon 把个人网站做成一个可以开车探索的小世界,用方向键驾驶小车撞开展品、浏览作品,是创意作品集网站里被引用最多的例子之一。
作品展示Shopify 每季产品发布的专题页,用 3D 场景与滚动动画串起上百项更新,展示了 Three.js 在大品牌营销页里的用法。
作品展示在浏览器里无限生成道路与风景的驾驶游戏,打开即玩、不用安装,后来还上架了 Steam,说明网页 3D 也能撑起完整的游戏体验。
