Three.js 基础入门与第一个三维场景
认识 Three.js 的核心对象关系,在 Vue3 页面中创建并渲染一个可见的三维立方体。
🎯 引言
学完这篇文章,你能在 Vue3 页面中创建一个三维场景,理解场景、相机、渲染器、几何体、材质和网格之间的关系,并渲染出第一个立方体。
🧱 Three.js 是什么
Three.js 是运行在浏览器中的 3D JavaScript 库,它把 WebGL 的绘图细节封装成场景、相机、材质等更容易使用的对象。你可以用它制作产品展示、三维数据可视化、模型查看器和交互动画。
一个 Three.js 画面可以先记成这条链路:
场景 Scene + 相机 Camera + 渲染器 Renderer → 画面
几何体 Geometry + 材质 Material → 网格 Mesh → 加入场景
- Scene 是放置物体和灯光的容器。
- Camera 决定从哪里观察,以及哪些范围能被看到。
- Renderer 把相机看到的场景绘制到
<canvas>。 - Geometry 描述物体的形状。
- Material 描述物体的颜色和表面效果。
- Mesh 把几何体和材质组合成可以显示的物体。
🚀 安装与最小场景
当前课程使用 Node.js v22.0.0 和 Three.js 0.185.1。在已有的 Vue3 项目中执行:
npm install three@0.185.1
下面的代码只渲染一帧,适合先理解初始化顺序。
components/FirstScene.vue
<template>
<div ref="containerRef" class="scene"></div>
</template>
<script setup>
import { onMounted, ref } from 'vue';
import * as THREE from 'three';
const containerRef = ref(null);
onMounted(() => {
const scene = new THREE.Scene();
const camera = new THREE.PerspectiveCamera(60, 320 / 240, 0.1, 100);
camera.position.set(2, 2, 4);
camera.lookAt(0, 0, 0);
const geometry = new THREE.BoxGeometry(1, 1, 1);
const material = new THREE.MeshStandardMaterial({ color: 0x44aa88 });
const cube = new THREE.Mesh(geometry, material);
cube.rotation.set(0.5, 0.7, 0);
scene.add(cube);
scene.add(new THREE.HemisphereLight(0xffffff, 0x445566, 2));
const renderer = new THREE.WebGLRenderer({ antialias: true, alpha: true });
renderer.setSize(320, 240);
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
renderer.outputColorSpace = THREE.SRGBColorSpace;
containerRef.value.appendChild(renderer.domElement);
renderer.render(scene, camera);
});
</script>
renderer.render(scene, camera) 的参数顺序固定为“渲染哪个场景、使用哪台相机”。如果物体没有加入 scene,或者相机没有看到物体,画布会正常出现但画面可能是空的。
下面是这段代码的真实渲染效果:
Three.js 依赖浏览器的
canvas 和 WebGL 环境,初始化代码放在组件挂载到浏览器后执行;使用服务端渲染时,不要在服务端阶段直接创建 Scene 或 WebGLRenderer。🧾 小节总结
Scene、Camera、Renderer共同完成一次渲染。Geometry + Material组合成可显示的Mesh。- 物体必须加入场景,相机必须能看到物体。
- Three.js 的空间单位不是像素,物体大小由相机和距离共同决定。
renderer.render()只渲染当前这一帧,连续画面要到动画篇学习。
❓ 知识问答
Q1:Three.js 和 WebGL 是什么关系?
WebGL 是浏览器提供的底层 3D 绘图接口,Three.js 在它上面提供了更易用的场景和对象抽象。
Q2:为什么标准材质需要灯光?
MeshStandardMaterial 会根据灯光计算明暗,没有光源时物体可能很暗;后面的材质与灯光篇会专门说明。
Q3:为什么相机常常放在 z 轴正方向?
Three.js 默认让相机朝向负 z 方向看,放在 z 轴正方向可以看到原点附近的物体。
🧪 小练习
把示例改造成一个长方体:宽度设为 2,高度设为 1,深度设为 0.5,再修改相机位置观察画面变化。
// 请在这里编写代码
🎉 你已经完成了第一个三维场景。接下来学习物体如何移动、旋转和缩放。
