Web 图形与 3D / 系统课时
glTF 与 GLB 文件如何选择
glTF 与 GLB 文件如何选择
同一套产品模型可以导出为 .gltf 或 .glb,但它们在文件组成、调试方式和上线分发上并不相同。选对格式后,你能判断哪些文件必须一起部署,并用 Three.js 验证模型是否完整加载。
学习目标
- 区分 glTF JSON、二进制缓冲区、纹理与 GLB 容器的职责。
- 根据调试、资源复用和线上分发场景选择交付格式。
- 使用同一套
GLTFLoader代码验证两种文件。
两种文件实际存放了什么
glTF 2.0 是资产格式规范,不是单指 .gltf 文件。 .gltf 是可阅读的 JSON 描述,保存节点层级、网格引用、材质、动画等信息;顶点、索引等数据通常放在外部 .bin 文件,贴图则由 images 中的 URI 引用 PNG 或 JPEG 文件。
例如 product.gltf 可以引用 product.bin 和 textures/basecolor.png。打开 JSON 检查 buffers[*].uri、images[*].uri,即可核对依赖。.gltf 也能使用 data: URI 内嵌资源,但 Base64 会让被编码数据增大约三分之一,不宜仅为了单文件而默认选它。
.glb 是二进制容器,典型结构为文件头、JSON 块和 BIN 块。网格数据及纹理图像可以通过缓冲区视图放入 BIN 块,从而形成一个自包含文件。但 GLB 仍允许外部资源引用,不要只凭扩展名断定部署时只需一个文件。

按交付场景选择格式
| 交付场景 | 推荐 | 选择依据 |
|---|---|---|
| 排查材质名称、纹理 URI、节点层级 | .gltf 加外部文件 |
JSON 易检索,单独替换贴图方便 |
| 单件产品上传 CDN、跨团队交付 | 自包含 .glb |
减少漏传依赖和路径错误 |
| 多款产品共享同一张大纹理 | .gltf 外链纹理 |
资源可独立缓存与复用 |
| 移动端页面追求加载性能 | 先选易部署格式,再实测 | 文件后缀不决定三角面数、显存和解码成本 |
假设一件商品包含 1 份 JSON、1 份 BIN 和 3 张贴图,外链 .gltf 通常需要请求 5 个资源;全部打包后的自包含 .glb 通常只请求 1 个文件。但请求数减少不等于体积一定更小:网络缓存、纹理压缩、网格压缩和设备解码能力都可能改变实际耗时。
用 GLTFLoader 验证两种资产
在已安装 three 的 Vite 原生 JavaScript 工程中,将模型放到 public/models/product.glb,用以下代码替换入口 main.js。启动 npm run dev 后查看页面和浏览器控制台。测试 .gltf 时,连同 .bin、纹理一起部署,保持 JSON 中的相对 URI 有效,再将代码末尾 URL 改为 /models/product.gltf。
import * as THREE from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf4f6f8);
scene.add(new THREE.HemisphereLight(0xffffff, 0x666666, 3));
const camera = new THREE.PerspectiveCamera(45, innerWidth / innerHeight, 0.01, 1000);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(innerWidth, innerHeight);
document.body.style.margin = '0';
document.body.appendChild(renderer.domElement);
async function showModel(url) {
// 两种封装格式都由同一个加载器解析
const asset = await new GLTFLoader().loadAsync(url);
const model = asset.scene;
const bounds = new THREE.Box3().setFromObject(model);
if (bounds.isEmpty()) throw new Error('模型没有可用的几何体');
// 根据包围盒居中,并为不同尺寸的资产设置观察距离
const center = bounds.getCenter(new THREE.Vector3());
const radius = bounds.getSize(new THREE.Vector3()).length() / 2;
model.position.sub(center);
scene.add(model);
const distance = Math.max(radius * 3, 2);
camera.position.set(distance * 0.35, distance * 0.2, distance);
camera.far = Math.max(1000, distance * 10);
camera.updateProjectionMatrix();
camera.lookAt(0, 0, 0);
renderer.render(scene, camera);
console.log('模型加载成功');
}
showModel('/models/product.glb').catch(console.error);预期结果:页面出现居中的产品模型,控制台显示:
模型加载成功更换为完整的 .gltf 资产后,应得到相同场景;如果模型材质、贴图或尺寸不同,应先核对两份导出是否来自同一版本源文件。
上线前核对资产完整性
- 对
.gltf检查buffers与images中的 URI,确认所有外部文件已上传,且目录大小写与引用一致。 - 对
.glb不仅检查文件存在,还要确认是否仍引用外部贴图或缓冲区;自包含交付不得遗漏任何依赖。 - 打开浏览器开发者工具的 Network,过滤
product、.bin、.png、.jpg,确认资源请求成功。出现404时先查路径;下载成功但不显示时再查模型包围盒、材质和导出内容。 - 对比同一网络条件下的总传输字节、请求数量与模型可见时间,不用“GLB 一定更快”替代实测。
单个产品模型的线上交付可优先使用经验证的自包含 .glb;需要频繁检查 JSON 或替换共享纹理时,保留外链 .gltf 作为开发资产。