Web 图形与 3D / 系统课时
用 glTF Transform 清除冗余资源
用 glTF Transform 清除冗余资源
从 Blender 导出的 GLB 可能包含重复材质、纹理和已失去引用的网格。这里用 glTF Transform 先检查、再去重和清理,留下可回退的中间文件,并用结构报表与 Three.js 实际加载结果确认动画和材质没有损坏。
学习目标
- 区分
dedup可合并的重复数据与prune可删除的无引用数据。 - 使用 CLI 对 GLB 分步清理,比较文件大小及资源数量。
- 验证节点名称、蒙皮、材质和动画仍满足运行时需求。
识别冗余与引用边界
glTF 资源之间存在引用关系:场景引用节点,节点引用网格或骨架,网格图元引用顶点 Accessor 和材质,材质再引用纹理;动画通道则指向节点。判断资源能否清理,必须沿引用关系检查,而不能只看名称。
dedup比较 Accessor、纹理、材质、网格和 Skin 等资源的内容,尽可能把相同资源改为共享引用;它不会把两个形状不同的网格强行合并。prune移除不再被场景引用的属性及资源。例如删除模型上的装饰节点后,原网格与材质可能成为可清理对象。- 如果某段动画只作用于场景树之外的节点,
prune可能把它视为未使用;计划运行时重定向的动画,不应未经检查就直接清理。

分步执行可回退的清理
以下适用于 glTF Transform CLI 4.5.1、Node.js LTS 和 Bash 环境。在已有 package.json 的项目根目录执行,并准备有效的 assets/character.glb。本轮只做重复资源合并与无引用资源清理,不启用会改变几何精度或纹理格式的压缩。
set -e
npm install --save-dev @gltf-transform/cli@4.5.1
mkdir -p dist
# 清理前先记录资源表,原始文件始终不覆盖
npx gltf-transform inspect assets/character.glb --format md > dist/before.md
npx gltf-transform dedup assets/character.glb dist/character-dedup.glb
# 保留自定义顶点数据、空挂点和纯色纹理的原始形式
npx gltf-transform prune dist/character-dedup.glb dist/character-clean.glb --keep-attributes true --keep-leaves true --keep-solid-textures true
npx gltf-transform inspect dist/character-clean.glb --format md > dist/after.md
npx gltf-transform validate dist/character-clean.glb
wc -c assets/character.glb dist/character-clean.glb
test -s dist/character-clean.glb
printf 'PASS: clean GLB exists\n'预期结果:两份 Markdown 资源报表及 dist/character-clean.glb 均已生成;wc 显示实际字节数,随输入文件而变化。输入合法且全部命令成功时,终端最后一行为:
PASS: clean GLB exists三个保留选项用于降低误删风险:--keep-attributes true 避免剔除运行时可能读取的额外顶点通道(例如用于光照贴图的 TEXCOORD_1);--keep-leaves true 保留空叶节点挂点;--keep-solid-textures true 避免把纯色纹理替换为材质常量。它们不保证保留所有场景外资源。
对比文件体积与资源表
打开 dist/before.md 与 dist/after.md,按 Scene、Mesh、Material、Texture、Animation 表逐项比对。dedup 后材质或网格数量下降,并不代表可见物体数量应该下降;多处节点可能开始共享同一底层资源。
例如,原文件 14 MiB、清理后 11 MiB,减少 3 MiB,体积下降约 21.4%。这是计算示例,不是上一段命令的固定输出。实际以 wc -c 的字节数计算:(原始字节数 - 清理后字节数) / 原始字节数 × 100%。
检查时优先确认动画片段的名称和数量、可见网格的结构、使用中的材质及贴图是否符合预期。只要文件变小却丢了动画或贴图,就不能视为成功。若大小几乎不变,通常意味着原文件冗余较少;不必为了追求压缩率继续删除资源。
在 Three.js 中完成回归验证
GLB 通过 validate 只说明格式检查结果,不能证明业务脚本依赖的名称、挂点和外观都未变。将清理后的文件复制到 Vite 项目的 public/models/character-clean.glb,用原场景的相机、灯光和动画逻辑做并排测试。
- 分别用
GLTFLoader.loadAsync()加载原版与清理版,比较gltf.animations.map(clip => clip.name);预期使用中的动作名称与数量一致。 - 用
gltf.scene.getObjectByName('实际节点名')检查代码依赖的骨骼、武器挂点和碰撞辅助节点;不存在时停止替换正式资源。 - 播放 Idle、Walk 等实际使用的动作至少各一个循环,检查蒙皮拉伸、Morph Target、材质颜色、透明度与纹理朝向。
- 在同一设备、相同相机位置下记录加载字节数、加载耗时和帧时间。
dedup、prune主要减少冗余数据,并不保证 Draw Call 或帧时间降低。
清理版只有同时通过格式检查、资源表核对和实际动画渲染测试,才适合替换上线资产。