Minecraft 开发环境 Intellij IDE 的 Run Configuration 损坏修复
问题
在升级 Intellij IDEA、修改系统中的 JDK 配置后,打开某些许久未启动的项目时, 总易发现已存在的,用于启动 Minecraft Server 或 Minecraft Client 的 Run Configuration 会被 IDEA 标红,无法运行
直接把这些 Run Configuration 删掉并运行 Gradle 任务自动生成一份?并不能解决问题,新生成的 Run Configuration 依然是红彤彤的
简单粗暴地把 .idea
文件夹删掉,再重启打开这个项目?这固然能解决问题,但这个项目已有的 IDEA 项目配置数据等都会消失不见
有没有什么简单有效且不破坏 IDEA 项目配置数据的好方法呢?
说明
本文只考虑如下这种典型的 MC 开发环境:
- 使用 Intellij IDEA 这个 IDE
- 装有 Minecraft Development 这个插件
- 使用 Gradle 管理 Java 项目
- 使用 Loom / Architectury Loom 来配置 MC mod 开发环境
其他环境下若出现了类似问题,本文的提供方法不保证能用
本人能力有限,所提供的方法可能不够完善,存在一定局限性。如有大佬有更优雅、更治本的解决方案,或发现本文有遗漏或疏忽,欢迎随时指出
修复方法
方法很简单,只需删掉两个文件即可。具体步骤如下:
- 关闭 Intellij IDEA。只需关掉这个项目的窗口就行了
- 去项目文件夹里,删掉这两个文件
.idea/misc.xml
.idea/modules.xml
- 重新用 Intellij IDEA 打开这个项目。如果发现项目文件结构变成下图这样也问题不大,继续操作
- 菜单栏选择 File - Project Structure 打开窗口,重新配置 SDK,选择要用的那个 JDk,然后确认
- 最后,Sync 一下 Gradle 项目
- 等 Gradle Sync 结束,Intellij 处理完 Sync 结果后,就修好了。每个 Run Configuration 都不再泛红,可以正常运行,且之前的 Run Configuration 配置都完好如初
如果 Gradle Sync 会失败的话,建议先检查下自己的项目是否有 bug,毕竟上述操作都不影响此 gradle 项目的可运行性
为啥这能修好
(我猜的)删掉 .idea/
文件夹下的 misc.xml
、modules.xml
这俩文件,
就能重新触发 Intellij IDEA 某些配置的重新生成,借此就可以把原来的一些过时/损坏的配置给自动修好了:
- 删
misc.xml
能重新配置每个 Run Configuration 所使用的 JDK - 删
modules.xml
能重新生成了每个子项目的 Modules 配置
中英对照表
对于那些 Intellij IDEA 的语言设置为简体中文的读者,可参考如下中英对照表
英文 | 中文 |
---|---|
Run Configuration | 运行配置 |
File - Project Structure | 文件 - 项目结构 |
Gradle Sync | 同步 Gradle |
Project | 项目 |
Modules | 模块 |