如何在JavaFX FXML中直接引用JAR包内的CSS文件？

1. 确认Maven依赖配置 #

先检查pom.xml里的BootstrapFX依赖是否正确，示例配置如下：

<dependency>
    <groupId>org.kordamp.bootstrapfx</groupId>
    <artifactId>bootstrapfx-core</artifactId>
    <version>0.4.0</version> <!-- 可替换为当前最新稳定版本 -->
</dependency>

配置完成后执行Maven > Reload Project，让IntelliJ同步依赖。

2. 修正FXML中的资源引用路径 #

FXML里引用JAR内的CSS时，不需要开头的@/，直接使用完整类路径即可：

stylesheets="org/kordamp/bootstrapfx/bootstrapfx.css"

也可以加上classpath:前缀明确指定从类路径加载，可读性更强：

stylesheets="classpath:org/kordamp/bootstrapfx/bootstrapfx.css"

3. 检查IntelliJ的项目结构配置 #

打开File > Project Structure > Modules，切换到Sources标签页，确认src/main/java和src/main/resources分别被标记为Sources和Resources目录，确保类路径资源能被正确识别。

4. 代码手动加载的备选方案 #

如果FXML预览仍然报错（IntelliJ的预览功能对JAR内资源的支持存在局限性），可以在Java启动类中手动加载CSS，保证运行时正常：

import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Scene;
import javafx.stage.Stage;
import java.io.IOException;

public class MainApplication extends Application {
    @Override
    public void start(Stage stage) throws IOException {
        FXMLLoader loader = new FXMLLoader(getClass().getResource("/your-view.fxml"));
        Scene scene = new Scene(loader.load());
        // 从类路径加载BootstrapFX的CSS文件
        scene.getStylesheets().add(getClass().getResource("/org/kordamp/bootstrapfx/bootstrapfx.css").toExternalForm());
        stage.setScene(scene);
        stage.show();
    }

    public static void main(String[] args) {
        launch(args);
    }
}

关于FXML预览的说明 #

IntelliJ的FXML预览工具偶尔无法解析JAR包内的资源，这是IDE自身的限制。此时可以优先通过代码运行验证功能是否正常，预览问题可暂时忽略，或者临时将CSS复制到本地资源目录用于预览，运行时再改回JAR引用即可。

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