MMD 模型加载失败 — 全粉、空洞、全黑、全白

粉色占位 = 贴图丢失（最常见）

症状：模型加载后是统一的亮粉色——能看到形状，但全粉一片，没有任何颜色/纹理。

原因

MMD 找不到模型引用的纹理贴图文件。模型在 PMX 里记录了"皮肤贴图在 tex/skin.png"，但实际路径上没有这个文件。

排查修复

一步步来，每步检查一下：

Step 1：确认 tex 文件夹在正确位置

正确结构：
MyModel/
├── MyModel.pmx          ← 和 tex/ 在同一层级
├── tex/
│   ├── skin.png
│   ├── hair.png
│   └── ...

错误结构：
MyModel/
├── MyModel.pmx          ← tex/ 不见了！

Step 2：确认 tex 文件夹名和 PMX 里引用的一致

PMX 里硬编码了贴图文件夹名。如果模型写的是 tex/skin.png，但你的文件夹叫 Texture/ → 找不到。

修复：把文件夹改名和 PMX 里写的一致（通常是 tex）。

Step 3：确认贴图文件名没被改

和上面同理。PMX 里引用的是精确的文件名。

Step 4：用 PMX Editor 检查贴图路径

下载 PMX Editor（免费）
打开 .pmx 文件
右侧面板切到「材质」标签
找到贴图缺失的材质 → 手动指定正确的贴图路径
保存 → 回到 MMD 重新加载

模型全黑

症状：模型形状能看到，但全是黑色的，看不到颜色细节。

原因一：光源方向没照到模型

检查 MMD 照明面板：光源方向是不是在模型背后？

修复：把光源 XYZ 调到斜前方（比如 -500, -700, -500）。

原因二：环境光太低

环境光几乎为 0 → 所有阴影区域全黑。

修复：调高环境光数值（200+）。

原因三：材质颜色太暗

模型的材质本身颜色就接近黑色 → 叠加照明后更黑。

修复：PMX Editor 里把材质颜色调亮。

原因四：法线贴图反了

部分模型的法线贴图方向错误 → 光照计算完全错乱。

修复：PMX Editor 里翻转法线贴图（如果是模型问题，最好换模型）。

模型全白

症状：模型白色一片，没有颜色和纹理。

原因一：材质漫反射颜色被设成纯白

修复：PMX Editor 里把材质颜色调成正常色（皮肤 ≈ 浅粉，衣服 ≈ 衣服原色）。

原因二：高光/自发光太强

部分 MME 特效（Ray-MMD）可能让模型过曝。

修复：关掉 MME 特效看是否恢复正常。

模型穿模/穿插

症状：两个应该分开的部件互相穿透（手臂穿过身体、头发穿过头、裙摆穿过腿）。

原因一：物理刚体设置错误

最常见原因——刚体体积太大或碰撞组没设好。

修复：用 PMX Editor 缩小穿模部位的刚体体积，或调整碰撞组。详见「物理碰撞调整」页面。

原因二：手动姿势调整超过 IK 极限

摆姿势时让关节超过正常弯曲范围 → 物理引擎算不过来。

修复：把姿势调回正常范围，或关掉物理再摆。

原因三：模型本身物理就有问题

配布质量差的模型物理设置粗糙。最简单的修复 → 换一个物理口碑好的模型。

模型显示一半/缺部件

症状：加载后模型只显示一部分（只有头、没有身体；或身体有了手没了）。

原因一：PMX 文件损坏

压缩包下载时损坏、解压不完整。

修复：重新下载模型包 + 重新解压。

原因二：模型被 PMX Editor 打开过且保存时损坏

用 PMX Editor 打开再保存可能引入问题——尤其是旧版本 PMX Editor 处理新版本 PMX。

修复：不要用太老版本的 PMX Editor 编辑新模型。

原因三：模型组（Group）被意外隐藏

PMX 里有「显示/隐藏」开关——可能某个部件被关闭了。

修复：PMX Editor 里切到「组」标签，确保所有组都是「显示」状态。

模型材质闪烁/忽明忽暗

原因

MME 插件冲突（多个插件同时改材质）
Z-Fighting：两个面在同一个平面上抢渲染顺序
半透明材质和不透明材质顺序不对

修复：

关掉 MME 插件逐个排查
PMX Editor 里调整材质的渲染顺序
确保半透明材质最后渲染

模型加载后 T-Pose 姿势不对

症状：模型初始姿势（T-Pose）和 VMD 动作的默认姿态不一致——导致动作播放时整体错位。

原因

不同模型的默认站姿有差异：

手臂平伸（标准 T-Pose）
手臂略斜下（A-Pose）
其他自定义站姿

而社区 VMD 通常基于标准 T-Pose K 的帧。

快速修复

方案一：调整 VMD 适配模型（推荐）

在时间轴帧 0 手动调整模型姿势到匹配 VMD
在帧 0 Register 关键帧（全模型）
VMD 导入时勾选「追加」模式（从帧 1 开始）

方案二：找匹配模型的 VMD

配布者通常会标注"适配哪些模型"——找和你模型匹配的 VMD。

模型加载失败的终极排查

如果上述方案都试过了模型还是加载不上：

换模型试试——如果另一个模型能正常加载，问题出在这个模型包本身
重启 MMD——有时 MMD 加载缓存出问题
换 MMD 版本——9.26 和 9.32 对某些模型支持略有差异
用 PMX Editor 打开模型——PMX Editor 能打开说明模型文件本身没坏，是 MMD 加载机制问题
检查模型配布规则——部分模型只支持特定版本的软件

80% 的模型问题都能用「换模型」解决——社区好模型太多了，没必要死磕一个。