Assimp默认不处理材质和纹理路径，必须手动启用、解析并绑定，否则模型全黑或贴图丢失；常见错误包括scene为空、路径错误、未启用MTL加载、编码异常、库混用等。
能直接加载，但默认不处理材质和纹理路径——必须手动启用、手动解析、手动绑定，否则模型会全黑或贴图丢失。
Assimp::Importer.ReadFile 为什么返回空 scene 或报错
常见错误现象是 scene 为 nullptr，或 scene->mFlags & AI_SCENE_FLAGS_INCOMPLETE 为真，控制台输出类似 "Could not open file" 或 "Unsupported format"。
- 路径写错：Windows 下用
"models\backpack.obj"或R"(models/backpack.obj)"，别用正斜杠混反斜杠 - OBJ 文件带 MTL 但未启用材质加载：默认
ReadFile不读.mtl，需加aiProcess_OptimizeMeshes | aiProcess_FlipUVs | aiProcess_Triangulate等标志还不够，必须显式调用importer.SetPropertyInteger(AI_CONFIG_IMPORT_OBJS_USE_MATERIALS, 1) - 文件编码或换行符异常：某些导出器生成的 OBJ 含 Windows-1252 字符或 BOM，Assimp 可能静默失败；建议用 VS Code 保存为 UTF-8 无 BOM
- Release/Debug 库混用：
assimp.lib（Release）链接到 Debug 项目会触发 LNK2019，检查项目属性 → C/C++ → 代码生成 → 运行时库是否与 Assimp 编译时一致（/MT vs /MD）
aiScene 里怎么拿到顶点、法线、UV 和索引
Assimp 解析后数据在 CPU 内存中，不是 GPU 缓冲，不能直接传给 glVertexAttribPointer。你需要遍历 scene->mMeshes[i]，逐个提取字段并拼成你自己的 Vertex 结构体。
-
mesh->mNumVertices是顶点总数，mesh->mVertices是aiVector3D*数组，对应位置 -
mesh->mNormals可能为空（尤其 OBJ），若为nullptr且你启用了aiProcess_GenSmoothNormals，Assimp 会在加载时补全 -
mesh->mTextureCoords[0]是 UV 数组，注意mesh->GetNumUVChannels()可能大于 1，但多数模型只用第 0 通道 -
mesh->mFaces是面数组，每个aiFace的mNumIndices通常是 3（三角化后），mIndices指向顶点索引 - 切线空间（TBN）需启用
aiProcess_CalcTangentSpace，否则mesh->mTangents为nullptr
纹理路径怎么解析才不会全黑
OBJ + MTL 加载后，scene->mMaterials[i]->GetTexture 返回的是相对路径字符串（如 "texture_diffuse.jpg"），不是完整路径，也不会自动加载图片文件。
- 先用
scene->mRootNode->mName.C_Str()或你自己保存的directory（取自path.substr(0, path.find_last_of('/'))）拼出绝对路径 - 调用
material->Get(AI_MATKEY_TEXTURE_DIFFUSE, 0, aiTextureType_DIFFUSE, path)获取纹理路径，第 3 个参数必须是aiTextureType_DIFFUSE等具体类型，不能传aiTextureType_UNKNOWN - Assimp 不负责解码图片，你得用 stb_image、SOIL 或 glfwLoadTexture2D 手动加载该路径下的图像，再生成 OpenGL texture ID
- glTF/.glb 模型不同：纹理可能内嵌在二进制段，
scene->mTextures[i]->pcData指向内存块，mHeight == 0表示压缩格式（如 JPEG），需用stbi_load_from_memory解码
为什么模型翻转、镜像或法线朝向错误
Assimp 默认使用右手坐标系，但 OpenGL 是左手（Z 向外），而很多 DCC 工具（如 Blender 导出 OBJ）默认 Y 向上、Z 向前，导致模型“躺平”或背面被剔除。
- 最简单修复：加载后对每个顶点位置
y和z坐标交换，并翻转z（即vec3(x, z, -y)），同时法线也做同样变换 - 更规范做法：在渲染前对整个模型应用一个坐标系转换矩阵，比如
glm::scale(glm::mat4(1.0f), glm::vec3(1, -1, 1))，但要注意这会影响法线变换，需用逆转置矩阵 -
aiProcess_FlipUVs必须开启，否则纹理上下颠倒；但它只翻转 UV，不碰几何——别指望它修正模型朝向 - FBX/GLB 更复杂：它们自带世界变换，
aiNode::mTransformation需递归应用到每个 mesh，漏掉会导致子部件错位
真正麻烦的不是加载本身，而是从 aiScene 到你自己的 Mesh 类之间那层映射逻辑——顶点去重策略、索引重排顺序、材质参数到着色器 uniform 的绑定方式，这些地方一旦错配，轻则贴图错位，重则崩溃或 GPU 资源泄漏。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
