把文件交给它
选择或拖入 .gltf或.glb 文件;也可以直接把内容粘进来。
把 .gltf 或 .glb 文件拖进来,或直接粘贴 glTF JSON 文本,检查器就在本页内读出它的结构。GLB 会列出 12 字节文件头以及每个分块的偏移、长度、类型和填充是否合规。两种格式都会显示文件声明的 glTF 版本、生成工具和版权,统计场景、节点、网格、图元、访问器、缓冲视图、缓冲区、材质、纹理、图像、采样器、蒙皮和动画的数量,并用表格展示节点层级,遇到循环引用或超过 256 层时停下并给出出问题的路径。每个访问器都会对照所属缓冲视图的字节长度检查是否越界、偏移是否对齐,每个缓冲视图对照所属缓冲区,场景、节点、网格、材质、纹理和图像中的索引引用也会核对范围。外部 URI 按原文列出并标注上级目录、绝对路径等特征,内嵌 data URI 只测量解码后的字节数,重复的 JSON 键和 __proto__ 之类的键也会报告,完整结果可下载为 JSON 报告。
或把文件拖到这里
选择或拖入 .gltf或.glb 文件;也可以直接把内容粘进来。
文件在你的浏览器里读取和解析,不会先传到服务器。
看一眼识别或转换的结果,再用页面上的复制、下载等操作。
想知道文件是怎么处理的? 看统一的隐私说明 →
把 .glb 文件拖进本页即可,检查器会在页面内读出文件头、分块和 glTF JSON。结果包括场景、节点层级、网格、访问器、材质、纹理、图像以及各分块的偏移与长度,还能下载 JSON 报告。它不绘制 3D 画面,想看模型外观请另用 3D 查看器。
可以,选 .gltf 文件或直接粘贴 glTF JSON 文本,检查结果完全一样。开头的字节顺序标记(BOM)会被去掉并在报告中注明,不会导致解析失败。粘贴的文本没有文件名,下载的报告名为 gltf-inspection.json;二进制 GLB 只能以文件方式选择。
不会,文件只在当前浏览器标签页内读取解析,检查期间不发任何网络请求。glTF 里通过外部 URI 引用的缓冲区和贴图只以文本列出并标为「未获取」,不会去访问那些地址。
用 Windows、macOS 或 Linux 上的新版浏览器打开本页即可,无需装 3D 软件或注册。Chrome、Edge、Firefox、Safari 都可以。得到的是结构报告而不是渲染画面,适合排查某个程序为什么拒绝加载这个文件。
可以,在 iPhone 或安卓手机的新版浏览器里选择 .glb,结果与电脑上一致。文件可以从「文件」应用或下载目录里选。上限同样是 200 MB,但手机内存较小,特别大的 GLB 更可能让标签页在出结果前重新加载。
这表示 GLB 文件头记录的总长度与实际字节数对不上,多半是文件被截断了。报错会同时给出声明长度和实际长度,常见原因是下载或拷贝中断,请重新下载或重新导出。如果提示的是 ERR_CHUNK_LENGTH_EXCEEDS_INPUT,则是某个分块声称的长度超过了它后面剩余的字节。
本工具只读 glTF 2.0,版本缺失、不是 2.x 或 minVersion 高于 2.0 都会被拒绝。例如 asset.version 写的是 1.0 的旧文件就属于这种情况。报错会原样给出文件声明的版本字符串,请在建模软件里重新导出为 glTF 2.0。
单个文件最大 209,715,200 字节(200 MB),节点层级最多追踪 256 层。glTF JSON 最多嵌套 128 层、包含 400 万个值;每张表最多显示 5000 行,可下载的报告上限 300 万字符,任何截断都会给出提示。
能打开,但受压缩影响的部分会标为「未解读」,报告注明不完整。这发生在 KHR_draco_mesh_compression、EXT_meshopt_compression 或 KHR_texture_basisu 等扩展列在 extensionsRequired 里的时候。本工具理解的必需扩展只有 KHR_mesh_quantization、KHR_texture_transform、KHR_materials_unlit 和 KHR_materials_emissive_strength。
本页检查时不渲染、不执行任何内容,但不做病毒扫描,也不会断言文件安全。它会标出含 ../、绝对路径、网络路径、Windows 盘符或 file: 协议的外部 URI,报告 __proto__ 等可疑键而不让它们影响页面,并把含 script 标签或 javascript: 链接的名称显示为纯文本。之后用其他 3D 软件打开时,这些 URI 仍可能被访问。
不是,没有发现只说明列出的检查都没触发,不等于完整的规范校验。它也不保证任何引擎都能加载:顶点数值、动画和蒙皮不会被解码,generator、版权和 extras 都是文件自己的声明。JSON 报告里列出了实际执行过的每一项检查。
gltf 是 JSON 文本,glb 是把同样的 JSON 和二进制数据打包成的单个文件。gltf 的缓冲区和贴图放在单独文件或 data URI 里;glb 带 12 字节文件头,后面跟 JSON 分块和一个可选的 BIN 分块。两种都能检查;扩展名是 .gltf 但内容其实是二进制的文件会报 ERR_EXTENSION_MISMATCH,改名为 .glb 即可。