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 仍允许外部资源引用,不要只凭扩展名断定部署时只需一个文件。

glTF 外链资源与自包含 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。

js
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);

预期结果:页面出现居中的产品模型,控制台显示:

text
模型加载成功

更换为完整的 .gltf 资产后,应得到相同场景;如果模型材质、贴图或尺寸不同,应先核对两份导出是否来自同一版本源文件。

上线前核对资产完整性

  1. 对 .gltf 检查 buffers 与 images 中的 URI,确认所有外部文件已上传,且目录大小写与引用一致。
  2. 对 .glb 不仅检查文件存在,还要确认是否仍引用外部贴图或缓冲区;自包含交付不得遗漏任何依赖。
  3. 打开浏览器开发者工具的 Network,过滤 product、.bin、.png、.jpg,确认资源请求成功。出现 404 时先查路径;下载成功但不显示时再查模型包围盒、材质和导出内容。
  4. 对比同一网络条件下的总传输字节、请求数量与模型可见时间,不用“GLB 一定更快”替代实测。

单个产品模型的线上交付可优先使用经验证的自包含 .glb;需要频繁检查 JSON 或替换共享纹理时,保留外链 .gltf 作为开发资产。

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

目录与阅读设置

阅读设置

17

记录一个想法

glTF 与 GLB 文件如何选择

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

登录哪都通