Web 图形与 3D / 系统课时
几何体与材质为何需要 dispose
几何体与材质为何需要 dispose
把一个展品从 Three.js 场景中移走,并不代表它占用的 GPU 缓冲区、着色器资源和纹理已经释放。本篇用两个共享资源的方块演示何时调用 dispose(),以及如何通过渲染统计确认展品切换后没有持续累积资源。
学习目标
- 区分
scene.remove()、JavaScript 垃圾回收和dispose()。 - 判断几何体、材质及纹理的共享关系,避免提前释放。
- 使用
renderer.info.memory检查资源是否按预期回收。
移除场景节点为何还会占用资源
scene.remove(mesh) 只解除对象与场景的父子关系,不会自动执行 mesh.geometry.dispose()。即使 Mesh 不再绘制,之前创建的 WebGL 资源也可能继续存在;JavaScript 垃圾回收不能代替应用主动通知渲染器释放它们。
| 资源 | 应调用的接口 | 回收对象 |
|---|---|---|
BufferGeometry |
geometry.dispose() |
顶点、索引等 GPU 缓冲资源 |
Material |
material.dispose() |
材质关联的着色器程序等资源 |
Texture |
texture.dispose() |
GPU 纹理对象 |
material.dispose() 不会顺带释放 material.map、normalMap 等纹理,因为同一张纹理可能被多个材质引用。dispose() 也不会替你移除场景节点或清除 JavaScript 变量;两类清理要分别处理。
共享资源应在最后一个使用者离开后释放
假设展厅里有两个 Mesh,都引用同一个 BoxGeometry、MeshBasicMaterial,而材质的 map 又引用同一张 CanvasTexture。移除左侧展品后,右侧仍依赖全部三项资源,此时执行任何一项 dispose() 都属于过早释放。

工程里应明确谁拥有资源:共享资源交给展厅或资源管理器持有,在最后一个使用者退出后统一释放;只属于单个临时展品的资源,则可以在该展品卸载时释放。不能仅凭“已从当前组移除”就断定它没有其他引用。
用两个共享方块验证释放时机
准备 Node.js 和 npm,依次运行 npm create vite@latest dispose-demo -- --template vanilla、cd dispose-demo、npm install、npm install three。将下面代码完整替换为 src/main.js,再执行 npm run dev,打开终端给出的本地地址。
import * as THREE from 'three';
const host = document.querySelector('#app');
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(640, 360);
host.appendChild(renderer.domElement);
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf8fafc);
const camera = new THREE.PerspectiveCamera(45, 640 / 360, 0.1, 100);
camera.position.set(0, 0, 5);
const canvas = document.createElement('canvas');
canvas.width = canvas.height = 64;
const ctx = canvas.getContext('2d');
ctx.fillStyle = '#20a89d';
ctx.fillRect(0, 0, 64, 64);
ctx.fillStyle = '#ffffff';
ctx.fillRect(16, 16, 32, 32);
// 两个 Mesh 明确共用同一组资源。
const texture = new THREE.CanvasTexture(canvas);
texture.colorSpace = THREE.SRGBColorSpace;
const geometry = new THREE.BoxGeometry(1.4, 1.4, 1.4);
const material = new THREE.MeshBasicMaterial({ map: texture });
const left = new THREE.Mesh(geometry, material);
const right = new THREE.Mesh(geometry, material);
left.position.x = -1.1;
right.position.x = 1.1;
scene.add(left, right);
const removeLeft = document.createElement('button');
const removeRight = document.createElement('button');
removeLeft.textContent = '移除左侧';
removeRight.textContent = '移除右侧并释放';
removeRight.disabled = true;
host.prepend(removeLeft, removeRight);
let released = false;
function releaseShared() {
if (released) return;
// 材质不会自动释放它引用的纹理。
geometry.dispose();
material.dispose();
texture.dispose();
released = true;
}
function report(stage) {
renderer.render(scene, camera);
const { geometries, textures } = renderer.info.memory;
console.log(`${stage}:几何体 ${geometries},纹理 ${textures}`);
}
report('初始');
removeLeft.onclick = () => {
scene.remove(left); // 右侧还在使用共享资源。
removeLeft.disabled = true;
removeRight.disabled = false;
report('移除左侧');
};
removeRight.onclick = () => {
scene.remove(right);
releaseShared();
removeRight.disabled = true;
report('移除右侧');
};
window.addEventListener('pagehide', () => {
releaseShared();
renderer.dispose();
}, { once: true });预期结果:页面先显示左右两个带纹理的方块。依次点击“移除左侧”和“移除右侧并释放”,浏览器开发者工具的 Console 在这个最小场景中应显示:
初始:几何体 1,纹理 1
移除左侧:几何体 1,纹理 1
移除右侧:几何体 0,纹理 0第一步计数不下降是正确现象,因为右侧仍引用同一套资源;最后一步同时调用三种 dispose(),才会完成回收。released 标志用于避免在按钮操作和页面退出时重复执行释放逻辑。
如何检查真实展厅是否泄漏
renderer.info.memory.geometries 和 renderer.info.memory.textures 是资源数量,不是显存字节数。测试时先渲染一帧,再连续进入、退出同一展区 10 次,分别记录每次退出后的计数;若不断抬升且不回到稳定基线,就要排查漏掉的引用与资源。
- 模型树:通过
group.traverse()找到子Mesh;材质可能是数组,需要逐个处理。用Set去重,但必须先确认资源没有被其他展区共享。 - 纹理和环境:除
map外检查normalMap、roughnessMap、scene.environment和scene.background中实际持有的纹理;不要把共享纹理连带清掉。 - 其他 WebGL 资源:
WebGLRenderTarget、后处理 Pass 和控制器在不再使用时按各自 API 调用dispose();动画循环和事件监听也要停止或解绑。 - 整个页面卸载:不再需要当前
WebGLRenderer时才调用renderer.dispose();若纹理的数据源是ImageBitmap,还要在确定无人使用后调用它的close()处理 CPU 侧资源。
Three.js 可能保留内部环境贴图等缓存,因此真实项目的计数不必强求归零。正确的验收标准是:重复装载同一组展品后,退出阶段的计数不随次数持续增长。