JavaFX打包Jar文件运行时无法找到FXML文件异常求助

我之前也碰到过一模一样的坑——为了规范结构分包，结果打包运行时FXML死活找不到，复制到Jar同级目录也没用。给你梳理下问题根源和靠谱的解决办法：

问题核心原因 #

你复制FXML到Jar外部是没用的！JavaFX加载FXML默认是从**类路径（classpath）**读取，而不是本地文件系统。打包成Jar后，你的FXML文件应该是被打包到Jar内部的，外部的FXML文件程序根本不会去读。

具体解决步骤 #

1. 改用类加载器加载FXML资源 #

别再用本地文件路径（比如new File("FXML/xxx.fxml")），换成类加载器的getResource()方法，这是最关键的一步：

// 假设你的FXML在src/FXML/Main.fxml，打包后会在类路径的FXML目录下
URL fxmlUrl = getClass().getResource("/FXML/Main.fxml");
FXMLLoader loader = new FXMLLoader(fxmlUrl);

注意路径开头的/，它表示从类路径的根目录开始查找，不会受当前类所在包的影响，避免分包带来的路径混乱。

2. 检查IntelliJ的Artifact打包配置 #

确保你的FXML、CSS等资源文件夹被正确打进Jar：

• 打开 File → Project Structure → Artifacts
• 找到你创建的Jar artifact，查看右侧的「Output Layout」
• 如果FXML文件夹没在列表里，点击+ → Directory Content，选中你的FXML文件夹，这样打包时资源才会被包含进Jar

3. 验证Jar内部的资源结构 #

用解压工具打开你的Jar文件，检查里面是否有FXML文件夹，以及对应的.fxml文件是否在正确的位置。如果Jar里压根没有FXML文件，那肯定找不到，说明打包配置漏了资源目录。

4. 同步修正FXML内的资源引用 #

如果你的FXML里引用了CSS或图片，也要改成类路径方式，比如：

<AnchorPane stylesheets="@/CSS/main.css">

这里的@/同样表示从类路径根目录开始查找资源。

按照这些步骤调整后，应该就能解决找不到FXML的问题了——核心就是让程序从Jar内部的类路径加载资源，而不是依赖外部文件系统。

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