一、版本不匹配（占60%+，头号杀手）
典型表现
装完打不开、闪退、黑屏，提示Incompatiblemodversion/Unsupportedmod，加载器识别不到Mod
常见原因
游戏本体≠Mod版本
例：1.20.1的Mod塞进1.19.2游戏
加载器类型错配
Fabric/Quilt的Mod装到Forge环境，反之亦然
加载器版本过低
模组要求Forge≥47.4.0，你装47.1.0
运行时环境不对（MC尤甚）
1.17+要用Java17;1.20.5+常用Java21;用Java8直接崩
解决
核对：游戏版本→加载器类型+版本→Mod版本三者完全对齐
升级加载器到模组要求的最低版本，更换对应Java版本（MC）
二、依赖/前置缺失或版本错（约30%）
典型表现
启动报错：Missingrequiredmod/Dependencynotfound
加载列表有红名、闪退但无明确日志
常见原因
漏装核心前置Mod：
Fabric几乎都要FabricAPI;生物/动画Mod常要GeckoLib;配置类要ClothConfig
前置版本不够：要求Jade≥11.12.3，你装11.11.0，多个前置互相冲突（枪械/大型整合包常见）
解决
看模组页面“Requirements/Dependencies”，全部前置+版本号照抄安装
报错日志直接写明缺什么，按名下载对应版本
三、文件与路径错误（低级但高频）
典型表现
Mod放了没反应、管理器不显示，启动瞬间闪退、日志报路径异常
常见原因
放错文件夹，没放进对应版本的mods;多版本共存时串文件夹
路径含中文/空格/特殊符号，C:Users张三\mods易导致Java读取失败
文件被二次解压
把.jar再解压，放进一堆文件夹而非原文件
文件名乱改/后缀不对
改了.jar为.zip或中文命名过长
文件损坏/下载不全，校验码不匹配、大小明显偏小
解决
路径：全英文、无空格、无中文用户名，只放原始.jar/.zip，不要解压;别套文件夹
核对文件大小/重新下载
四、Mod冲突（多Mod必遇）
典型表现
单Mod正常，多Mod一起崩，提示DuplicateID/Blockalreadyregistered，随机闪退、功能异常
常见原因
ID冲突：两Mod用同一块/物品ID
API冲突：不同Mod嵌入不同版本的同库
功能重叠：两个大修同系统（如两个UI、两个地图）
加载顺序错误：前置/库类Mod需优先加载
解决
二分排查法：全禁用→分批启用→定位冲突组，看崩溃日志，找到ConflictbetweenAandB
用Mod管理器（Vortex/MC启动器）调整加载顺序，换兼容版本或删掉其中一个冲突Mod。
五、加载器/管理器问题
典型表现
管理器识别不到Mod，加载器安装后不生成mods文件夹，更新后突然失效。
常见原因
加载器安装选错游戏目录，管理器版本过旧、缓存损坏。
权限不足（未管理员运行）、杀软拦截，安装时被360/火绒误删关键文件。
解决
重装加载器，严格选对游戏根目录，管理器更新到最新、清空缓存。
管理员运行;把游戏目录加入杀软白名单。
六、游戏版本更新后旧Mod失效
典型表现
游戏自动更新后Mod全挂，旧存档打不开、闪退。
原因
新版本API变更，旧Mod未适配。
官方更新覆盖/损坏了Mod相关文件。
解决
回滚游戏到旧版本（Steam可在属性→测试版选旧版）。
等待Mod作者更新，或找适配新版本的替代Mod。
七、平台/特殊情况（Epic、微软商店、主机）
典型表现
Steam正常，Epic/微软商店装Mod没反应或闪退，账号绑定失败、Mod页面打不开。
原因
Epic/微软商店版本目录结构不同、默认禁止Mod。
平台账号与Mod平台未绑定（如WB账号），网络限制（外站N网/Mod平台连不上）。
解决
按平台专用教程安装（通常需额外补丁/启动器）。
加速器/换网解决N网、账号绑定问题，确认平台版本支持Mod，或改用Steam版。
八、系统/硬件/运行库问题
典型表现
所有Mod都装不上、普遍闪退，提示vcruntime140.dll/dxgi.dll缺失。
常见原因
VC++运行库、DirectX、.NETFramework缺失/版本旧。
32位系统装64位Mod/加载器，系统Win7过老（新Mod/管理器不再支持）。
显卡驱动过旧
解决
安装/修复：VC++2015–2022、DirectX11/12、.NET6+。
确认系统64位;Win7建议升Win10+，更新显卡驱动。
