基于IntelliJ默认JavaFX结构，如何打包含资源的原生可执行文件？

核心误区纠正 #

你用的--resource-dir参数是jpackage用于打包安装程序附加资源的（比如安装向导图片、自定义快捷方式图标、安装脚本等），完全不是给应用运行时加载资源用的，所以无效是正常的。

正确思路 #

你的项目是模块化结构（存在module-info.java），必须将src/main/resources下的资源作为模块的一部分打包，这样运行时getClass().getResource("/xxx")才能正常访问。资源不需要单独转成Jar，只需和编译后的类文件放在同一模块目录下，再通过jlink将整个模块纳入自定义运行时镜像，最后用jpackage打包即可。

具体命令步骤 #

假设你的模块名为helloworld，主类为helloworld.HelloWorldFX，JavaFX SDK路径为path/to/javafx-sdk，编译输出目录为target/classes：

1. 编译代码并复制资源 #

先编译Java代码，再将资源目录完整复制到编译输出目录（保持原目录结构）：

# 编译代码到target/classes
javac --module-path "path/to/javafx-sdk/lib" --add-modules javafx.controls,javafx.fxml -d target/classes src/main/java/helloworld/*.java src/main/java/module-info.java

# 复制资源（Windows用此命令）
xcopy /E src\main\resources\* target\classes\

# 复制资源（Linux/macOS用此命令）
cp -r src/main/resources/* target/classes/

2. 生成自定义运行时镜像 #

用jlink将你的模块和JavaFX依赖模块打包成轻量运行时镜像：

jlink --module-path "path/to/javafx-sdk/lib;target/classes" --add-modules helloworld --output target/runtime-image

3. 打包成原生安装包 #

基于上面的运行时镜像，用jpackage生成原生应用包（可替换--type为exe/dmg/deb等对应平台格式）：

jpackage --type app-image --runtime-image target/runtime-image --module helloworld/helloworld.HelloWorldFX --output target/installer

额外说明 #

• IntelliJ默认编译时会自动将src/main/resources的内容复制到编译输出目录（比如out/production/classes），你可以直接基于这个目录执行后续的jlink和jpackage命令，省去手动复制资源的步骤。
• 若使用Maven/Gradle，可借助javafx-maven-plugin或javafx-gradle-plugin自动化整个构建、打包流程，插件会自动处理资源复制、模块打包、jlink/jpackage调用，更高效。

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