如何在IntelliJ IDEA 2023中为Gradle JavaFX应用创建可执行MegaJar

问题重现 #

• 使用Add -> Jar -> From modules with dependencies生成的Jar，执行java -jar outputjar.jar时提示缺少Manifest
• 使用Add -> Jar -> Empty配置，Manifest可被识别，但运行时报错Error: Could not find or load main class com.foo.myapp.MainClass，原因是依赖的Gradle模块被以Jar形式嵌套打包，而Java不允许Jar嵌套

官方向导正确操作步骤 #

1. 打开File -> Project Structure -> Artifacts
2. 点击+按钮，选择Jar -> From modules with dependencies
3. 在弹出的配置窗口中：
   • 选中你的JavaFX主类（com.foo.myapp.MainClass）
   • 务必勾选Extract to the target JAR选项（此选项会将依赖Jar中的class文件提取到主Jar，避免嵌套问题）
   • 点击OK后，在左侧Artifacts列表选中刚生成的配置
   • 切换到Manifest File标签页，确认Manifest文件路径正确（默认路径为src/main/resources/META-INF/MANIFEST.MF，不存在则自动创建）
   • 检查Manifest中的Main-Class属性是否正确指向你的主类
4. 点击Apply和OK保存配置，执行Build -> Build Artifacts -> Build生成可执行Jar

之前操作的问题分析 #

• From modules with dependencies选项遗漏Manifest：多数情况是未在配置窗口指定主类，或是Manifest路径配置错误导致自动生成失败
• Empty选项引发Jar嵌套：Empty模式默认直接将依赖Jar打包进主Jar，不会自动提取依赖中的class文件，违反Java的Jar规范

是否为IntelliJ Bug？ #

在2023.3.2版本中，严格遵循上述步骤操作，From modules with dependencies向导应能正常生成带Manifest且无嵌套Jar的可执行Jar。若仍出现Manifest缺失，可能是项目结构特殊（如多模块Gradle配置）或向导的边缘场景Bug，此时手动修改.idea/artifacts下的XML配置可作为临时解决方案，也可尝试更新到IDEA最新版本验证问题是否修复

内容的提问来源于stack exchange，提问作者Bitbang3r