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,再修改相机位置观察画面变化。

// 请在这里编写代码

🎉 你已经完成了第一个三维场景。接下来学习物体如何移动、旋转和缩放。