Web 图形与 3D / 系统课时
比较 glTF 与 GLB 的交付差异
比较 glTF 与 GLB 的交付差异
同一套 Three.js 模型,可以交付为带外部资源的 .gltf,也可以封装为 .glb。这里通过资源引用、浏览器请求和打包验收判断两者的差异,给出可直接用于 Web 项目的格式选择与发布检查方法。
学习目标
- 识别 glTF JSON、二进制缓冲区、纹理与 GLB 容器的关系。
- 根据请求数量、缓存粒度和调试需求选择交付格式。
- 将多文件 glTF 转成 GLB,并检查是否仍依赖外部文件。
文件结构与引用方式
.gltf 是可阅读的 JSON,描述场景节点、网格、材质、动画及资源索引。顶点、索引和动画采样数据通常放在外部 .bin 中;images[].uri 可以引用 PNG/JPEG 文件,buffers[].uri 可以引用二进制文件。路径相对于 .gltf 文件解析。.gltf 也允许用 data: URI 内嵌数据,因此并非必然是多文件。
.glb 是二进制容器:前 12 字节为标识、版本和总长度,随后是 JSON Chunk,以及可选的 BIN Chunk。几何数据可放进 BIN,纹理也可通过 bufferView 内嵌。要注意:GLB 仍允许外部 URI;只有所有依赖都内嵌,才是真正的单文件交付。

传输、调试和缓存怎样取舍
假设商品模型包含一个 JSON、一个 .bin 和三张纹理,分离式 glTF 首次加载通常涉及 5 个资源请求;完全内嵌的 GLB 只请求 1 个文件。但请求数少不等于一定更快,HTTP/2/3 可并行传输,缓存命中和文件体积也会影响结果。
| 维度 | 分离式 glTF | 完全内嵌的 GLB |
|---|---|---|
| 资源管理 | 必须一起部署 JSON、BIN、纹理 | 通常只需部署一个文件 |
| 调试 | 可直接检查 JSON 与文件名 | 需要解析器或模型检查工具 |
| 缓存 | 多个模型可分别复用相同纹理 URL | 更新模型常使整个 GLB 缓存失效 |
| 请求 | 每个外部资源单独请求 | 通常一个请求即可获取整包 |
GLB 不是几何或纹理压缩算法。直接封装不会自动产生 Draco、Meshopt 或 KTX2 的压缩效果;把数据写成 data: URI 还会带来约三分之一的 Base64 编码膨胀。对比大小时应同时记录传输字节数和加载耗时,而非只比较扩展名。
转换资产并检查自包含性
下面适用于 Node.js LTS 和 macOS/Linux 的 Bash。先确认 assets/chair.gltf 及其引用的 .bin、纹理文件均存在,然后在项目根目录执行。示例使用 glTF Transform CLI 4.5.1 的 copy 命令,将资源写入 Vite 的 public/models。
mkdir -p public/models
npx --yes @gltf-transform/cli@4.5.1 copy assets/chair.gltf public/models/chair.glb >/dev/null
node <<'NODE'
const fs = require('node:fs');
const b = fs.readFileSync('public/models/chair.glb');
// 检查 GLB 2 文件头、总长度和首个 JSON 块。
if (b.toString('ascii', 0, 4) !== 'glTF' || b.readUInt32LE(4) !== 2 ||
b.readUInt32LE(8) !== b.length || b.toString('ascii', 16, 20) !== 'JSON') {
throw new Error('GLB 头或 JSON 块无效');
}
const n = b.readUInt32LE(12);
const doc = JSON.parse(b.subarray(20, 20 + n).toString('utf8'));
// URI 存在且不是 data: 时,仍须额外部署该依赖。
const refs = [...(doc.buffers ?? []), ...(doc.images ?? [])]
.map(item => item.uri).filter(uri => uri && !uri.startsWith('data:'));
console.log(`外部依赖: ${refs.length}`);
NODE预期输出(输入文件完整、资源均被内嵌时):
外部依赖: 0如果数字不为零,仍需按 URI 部署对应资源,不能当作单文件发布。此脚本只检验容器头和资源引用,不等同于完整格式校验;可再用 npx --yes @gltf-transform/cli@4.5.1 validate public/models/chair.glb 检查规范错误。copy 可能改变缓冲区布局并移除已有 Draco 压缩,转换后要重新比较文件体积。
在 Three.js 页面完成发布验收
Vite 中的 public/models/chair.glb 对应浏览器 URL /models/chair.glb,不是 /public/models/chair.glb。默认根路径部署时,将 /models/chair.glb 传给 GLTFLoader 实例的 load() 方法;部署到子路径时,改用 import.meta.env.BASE_URL + 'models/chair.glb' 组合资源地址。
- 打开浏览器开发者工具 Network,刷新页面,确认
.glb请求返回 HTTP 200,响应体确实是二进制模型,而非部署平台回退的 HTML。 - 检查 GLB 的响应类型可设置为
model/gltf-binary;分离式.gltf对应model/gltf+json。若纹理或.bin报 404,检查大小写、相对 URI 和 CDN 发布清单。 - 用
GLTFLoader实际加载并检查网格、纹理和动画;如果资源跨域,还要确认服务端的 CORS 许可。Network 中额外出现贴图请求时,重新核对是否真正内嵌。
单商品展示、离线分发和 CDN 静态部署通常优先选自包含 GLB;多模型共用大纹理、需要独立更新资源或频繁排查 JSON 时,可保留分离式 glTF。两者都应以实际加载成功、依赖完整和传输数据为验收标准。细节可参考 Khronos glTF 2.0 规范。