必须先用官方或第三方启动器启动一次原版游戏，否则Forge/Fabric无法识别基础依赖；需确认Java位数与系统匹配、选对加载器（Forge或Fabric）、正确安装前置及mod文件至.minecraft\mods根目录。
想给《我的世界》Java版装上飞行背包、自动农场或高清光影，却卡在mod安装这一步？不是报错“Missing API”，就是启动后黑屏闪退，甚至游戏根本打不开——问题往往不出在mod本身，而在于加载器、Java版本、启动器三者没对齐。
确认基础环境是否就绪
打开你的.minecraft文件夹（路径为C:\Users\你的用户名\AppData\Roaming\.minecraft），检查里面是否有versions和mods两个文件夹。没有mods文件夹就手动新建一个；如果versions里连一个.jar文件都没有，说明原版游戏还没成功运行过——【必须先用官方或第三方启动器启动一次原版游戏，否则Forge/Fabric无法识别基础依赖】。
右键桌面→“显示设置”→“关于”→查看系统类型。若显示“64位操作系统”，下一步必须下载64位Java；若仍是32位，请立即升级系统，因为32位Java最多只支持1GB内存，装任何mod都会崩溃。
选对模组加载器：Forge还是Fabric？
Forge和Fabric互不兼容，不能共存。选哪个取决于你要装的mod：
立即学习“Java免费学习笔记（深入）”；
方法一：查Mod页面底部标签。CurseForge或Modrinth上每个mod详情页都会明确标注“Requires: Forge 47.2.0”或“Requires: Fabric Loader 0.15.11”。跟着它写的需求走，别自己猜。
方法二：看整合包来源。如果你下载的是“青空物语”“虚无世界”这类大型整合包，90%用的是Forge；如果是“Lithium+Phosphor+Starlight”这类性能优化组合，基本锁定Fabric。
方法三：新手闭眼选Forge。它生态更成熟，报错信息更友好，教程多，适合第一次装mod的人。Fabric更适合进阶用户折腾底层性能。
安装Forge加载器（以1.20.1为例）
第一步：访问https://files.minecraftforge.net/ → 找到1.20.1版本 → 点击“Installer”下载exe文件。
第二步：双击运行安装程序 → 选择“Install client” → 点击“OK”。这一步会把Forge注入到.minecraft\versions.20.1-forge-47.2.0目录中，【不要点“Install server”，那是给开服用的，点了会导致客户端无法启动】。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
第三步：打开HMCL启动器 → 左侧“版本列表”刷新后会出现“1.20.1-forge-47.2.0” → 选中它 → 点击右下角“启动”。首次启动会卡在“Loading mods…”约20秒，这是正常现象，别急着关掉。
安装Fabric加载器（以1.20.1为例）
方法一（推荐）：用HMCL自动安装。启动器主界面 → 点击左上角“自动安装” → 在弹出窗口中选择“Fabric Loader” → 选版本1.20.1 → 点击“安装”。它会自动下载fabric-loader-0.15.11-1.20.1并配置好路径。
方法二（手动）：去https://fabricmc.net/use/下载对应版本的jar → 双击运行 → 选择“Install to Minecraft” → 确保下拉菜单里是“.minecraft”路径 → 点击“INSTALL”。完成后，versions目录里会出现fabric-loader-0.15.11-1.20.1文件夹。
注意：Fabric必须搭配Fabric API模组才能运行大多数功能型mod，这玩意儿不会自动装。你得单独去Modrinth搜“Fabric API”，下载与loader版本匹配的jar（例如loader是0.15.11，API就得下0.92.0+1.20.1），然后扔进mods文件夹。
把Mod文件放进正确位置
将你下载好的.mod文件（后缀为.jar或.zip）全部复制到.minecraft\mods文件夹里。不要建子文件夹，不要重命名，不要解压——【所有mod必须是直接放在mods根目录下的未解压jar包，否则加载器会直接忽略】。
如果mod带config文件夹，也一并复制进去；但不要把整个整合包压缩包直接丢进去，那毫无作用。
装完后启动游戏，主界面左下角会显示“Forge”或“Fabric”图标，进入单人世界按F3打开调试界面，左上角出现“Mods: XX loaded”才表示成功。
启动失败？快速定位三类典型错误
错误1：“java.lang.UnsupportedClassVersionError”。这是Java版本太高或太低。查一下你装的mod要求什么Java：1.17+用Java 17，1.12.2用Java 8。在HMCL启动器里点击版本→“编辑”→“Java设置”→手动指定Java路径，别用启动器自带的默认Java。
错误2：“Mod X requires mod Y version Z”。说明你漏装了前置依赖。比如装“Create”就必须先有“Flywheel”和“JEI”。去mod主页的“Dependencies”栏逐个补全，顺序不重要，但一个都不能少。
错误3：游戏启动后立刻崩溃，日志里反复出现“MixinApplyError”。大概率是两个mod冲突，常见于多个光影引擎（OptiFine + Iris）、多个实体优化（Phosphor + Lithium）。删掉其中一个再试。
