导出为Jar文件后JavaFX Application无法加载FXML文件

这种问题我之前也碰到过——IntelliJ里跑起来一切正常，打包成Jar就掉链子，核心原因是资源文件在Jar包中的访问方式和本地运行时完全不同。下面是一步步的排查和解决方法：

1. 修正FXML加载的代码逻辑 #

在本地运行时，你可能用了基于文件系统的路径来加载FXML，但Jar包是一个压缩文件，里面的资源不能用File类来访问，必须通过类加载器获取资源的URL。

错误的写法（仅本地运行有效）： #

// 依赖本地文件系统路径，Jar中会找不到资源
FXMLLoader loader = new FXMLLoader();
loader.setLocation(new File("src/main/resources/dialog.fxml").toURI().toURL());

正确的写法（本地+Jar都有效）： #

用当前类的类加载器来加载资源，路径开头的/代表从资源根目录开始查找：

// 非静态方法中使用
FXMLLoader loader = new FXMLLoader(getClass().getResource("/dialog.fxml"));

// 如果是静态方法，用当前类的Class对象
FXMLLoader loader = new FXMLLoader(YourCalculatorClass.class.getResource("/dialog.fxml"));

注意：如果你的FXML放在资源目录的子文件夹里（比如resources/fxml/dialog.fxml），路径要写成/fxml/dialog.fxml，别漏了子目录。

2. 确认资源被正确打包进Jar #

有时候问题出在打包过程中，资源文件没被包含进Jar里：

• 如果用Maven/Gradle构建：检查配置文件，确保src/main/resources被标记为资源目录（默认是包含的，但如果有自定义配置要确认）。比如Maven的pom.xml不需要额外配置，Gradle的build.gradle里要确保sourceSets.main.resources.srcDirs = ["src/main/resources"]。
• 如果用IntelliJ自带的Artifacts打包：打开File > Project Structure > Artifacts，检查你的Jar artifact的内容，确保resources目录下的FXML文件被添加到Jar的根目录（或者对应路径下），而不是只添加了编译后的class文件。

3. 验证Jar内部的结构 #

把Jar文件解压（直接改后缀为.zip解压即可），看看FXML文件是不是在你代码中指定的路径下。比如你代码里写的是/dialog.fxml，那解压后Jar根目录下必须有dialog.fxml；如果是/fxml/dialog.fxml，就要有fxml文件夹，里面有对应的文件。

4. 测试Jar的运行方式 #

确保你用正确的命令运行Jar：

java -jar FinishedCalCulator.jar

不要用错误的路径或者缺少依赖的方式运行，比如如果是JavaFX项目，可能需要指定模块路径（如果用模块化的话），不过你IntelliJ能运行，说明依赖应该没问题，重点还是资源加载的问题。

按照上面的步骤排查，应该能解决Jar中加载FXML DialogPane的问题。

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