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,打开终端给出的本地地址。

js
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 在这个最小场景中应显示:

text
初始:几何体 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 可能保留内部环境贴图等缓存,因此真实项目的计数不必强求归零。正确的验收标准是:重复装载同一组展品后,退出阶段的计数不随次数持续增长。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

几何体与材质为何需要 dispose

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通