tinygltf加载失败主因有四：未实现Buffer/Image Loader导致.bin和纹理缺失；bufferView/accessor索引错乱致顶点数据错误；Windows中文路径因fopen不支持UTF-8而静默失败；扩展如KHR_skinning未在extensionsUsed声明致动画/蒙皮丢失。
tinygltf 加载失败：找不到 model.bin 或纹理路径不对
tinygltf 默认只解析 glTF JSON（.gltf）本身，不会自动读取外部 .bin 文件或图片——它把路径当字符串存着，读不读、怎么读全靠你自己。
常见错误是直接调用 LoadASCIIFromFile() 后就以为模型“加载完了”，结果 model.buffers 为空，或者 model.images 里全是空数据。
- 必须手动实现
TinyGLTF::SetImageLoader()和TinyGLTF::SetBufferLoader()，否则所有二进制和图片都跳过 - buffer loader 要按
model.buffers[i].uri拼出完整路径（比如"scene.bin"得拼成"assets/scene.bin"），然后用fread或std::ifstream读进buffer->data - image loader 同理，但注意：glTF 允许 base64 内联图片（
data:image/png;base64,...），URI 以data:开头就得走 base64 解码，不能当文件读
顶点数据没对上：bufferView 和 accessor 索引错乱
tinygltf 把原始 buffer 数据、视图切片（bufferView）、语义解释（accessor）三层分开存，不是直接给你一个 std::vector<:vec3></:vec3>。手抖写错索引，轻则黑屏，重则越界崩溃。
典型表现：网格显示为一团乱线，或 accessor.count 明明是 1000，但读出来的顶点只有前 10 个有值。
立即学习“C++免费学习笔记（深入）”；
- 先确认
accessor.bufferView不是 -1（-1 表示数据内联在 accessor 的min/max里，仅限极小量元数据） - 再查
model.bufferViews[accessor.bufferView]的buffer索引是否有效，再查model.buffers[bufferView.buffer]是否已成功加载 - 最后算偏移：顶点起始位置 =
bufferView.byteOffset + accessor.byteOffset，每个顶点字节数由accessor.type（如VEC3）和accessor.componentType（如FLOAT）共同决定，别硬编码为sizeof(float) * 3
Windows 下中文路径加载失败：LoadASCIIFromFile() 返回 false
tinygltf 内部用 fopen() 打开文件，而 Windows 上 fopen() 不支持 UTF-8 路径（哪怕你的源文件名是中文）。编译器没报错，但函数默默返回 false，err 里只写 “Unable to open file”，非常误导。
这不是 tinygltf 的 bug，是 C 标准库限制。你得绕开它。
- Linux/macOS 一般没事；Windows 必须把路径转成宽字符，用
_wfopen()替换底层逻辑，或改用内存加载（先把文件用std::ifstream读到std::vector<char></char>，再调LoadASCIIFromString()） - 更稳妥的做法：统一用资源 ID 或相对路径，避免在路径里出现中文；如果必须支持，提前把 glTF 文件所在目录设为当前工作目录，再用纯文件名传入
- 别依赖
err字符串判断原因——它常为空，优先检查返回值和model.errors容器
动画和皮肤数据存在但 model.skins 为空？检查 extensionsUsed
有些导出器（比如 Blender 的某些插件）会把 skin 或 morph target 存在 KHR_animation_pointer 或 EXT_mesh_gpu_instancing 这类扩展里，而不是标准字段。tinygltf 默认不解析未声明的扩展。
现象是：模型静止不动，model.animations.size() 非零，但 model.skins.size() == 0，且节点 skin 索引是 -1。
- 先看
model.extensionsUsed里有没有"KHR_skinning"；没有的话，说明导出时没勾选“导出蒙皮”，或者用了非标准方式绑定骨骼 - 即使有，也要确认
model.skins是不是空——有些模型把 joints 放在 node 的extensions.KHR_lights_punctual里（误配），tinygltf 就不管 - 建议用 glTF Validator 检查模型合规性，比对着代码猜快得多
事情说清了就结束。最麻烦的永远不是加载，而是验证每一步的数据是否真被正确提取出来——尤其是 bufferView 的 byteLength 和 accessor 的 count 对不上时，得一层层打印索引和 size，别信直觉。
