本文旨在解决JavaFX程序在导出为JAR包后，FXML文件无法正确加载的问题。通常，这是由于构建配置不正确，导致资源文件未包含在JAR包中。本文将详细介绍如何配置构建过程，确保FXML文件被正确打包，并提供代码示例和注意事项，帮助开发者顺利发布JavaFX应用程序。
确保资源文件包含在JAR包中
JavaFX应用程序通常依赖FXML文件来定义用户界面。当程序在IDE中运行时，FXML文件通常可以正确加载，但在导出为JAR包后，可能会出现java.lang.IllegalStateException: Location is not set 错误，这通常表示程序无法找到FXML文件。
解决此问题的关键在于确保构建工具（例如IntelliJ IDEA的Artifacts功能或Maven）能够将资源文件夹（包含FXML文件）正确地包含到JAR包中。
在IntelliJ IDEA中配置Artifacts:
立即学习“Java免费学习笔记（深入）”；
- 打开 "File" -> "Project Structure..."
- 选择 "Artifacts"。
- 选择或创建你的JAR Artifact。
- 在Artifact的内容面板中，点击 "+" 按钮，选择 "Add Directory Content"。
- 浏览到你的资源文件夹（通常是 src/main/resources），并选择它。
- 点击 "OK" 保存配置。
通过以上步骤，你已经告诉IntelliJ IDEA将资源文件夹中的所有文件和子文件夹都包含到最终的JAR包中。
正确引用FXML文件
在Java代码中加载FXML文件时，需要使用正确的路径。如果FXML文件位于JAR包的根目录下，可以直接使用文件名。但是，如果FXML文件位于子目录中，则需要使用完整的相对路径。
示例代码:
假设你的FXML文件位于 src/main/resources/plop/SceneOuverture.fxml 目录下，则加载FXML的代码应该如下所示：
FXMLLoader fxmlLoader = new FXMLLoader(getClass().getResource("/plop/SceneOuverture.fxml"));
Parent root = fxmlLoader.load();
Scene scene = new Scene(root);注意，路径以 / 开头，表示从JAR包的根目录开始查找。如果你的FXML文件位于默认包中，则可以省略 /。
错误示例:
以下代码可能在IDE中运行良好，但在JAR包中会失败，因为它没有指定正确的路径：
FXMLLoader fxmlLoader = new FXMLLoader(getClass().getResource("SceneOuverture.fxml")); // 错误！
Parent root = fxmlLoader.load();
Scene scene = new Scene(root);注意事项
- 检查JAR包内容: 使用解压缩工具（如7-Zip）打开导出的JAR包，确认FXML文件是否位于正确的位置。
- 使用绝对路径: 虽然相对路径通常可以工作，但在某些情况下，使用绝对路径（相对于类路径）可以避免潜在的问题。
- 构建工具配置: 确保你的构建工具（例如Maven或Gradle）正确配置，以包含资源文件。
- 清理和重建: 在进行任何更改后，建议清理并重建项目，以确保所有文件都被正确地重新编译和打包。
总结
解决JavaFX JAR包中FXML文件缺失的问题，关键在于：
- 确保资源文件夹被正确地包含到JAR包中（通过配置构建工具）。
- 使用正确的路径加载FXML文件（使用绝对路径或相对于类路径的路径）。
通过遵循这些步骤，你可以避免常见的错误，并成功地发布你的JavaFX应用程序。
