Java中如何简化ClassLoader.getSystemResource()的资源访问路径

你当前必须编写完整层级路径的核心原因，是类加载器的资源搜索根路径覆盖到了main目录的上一级，main/res属于这个根路径下的嵌套子目录，因此只有完整写出从根路径到目标文件的全路径，类加载器才能匹配到对应资源。可以通过两种方式实现你期望的简化路径写法：

方案1：调整类路径资源根配置（行业标准实践，推荐使用） #

这种方式不需要在代码里硬编码冗余路径，是Java项目资源加载的规范做法：

• 打开IDE的项目模块设置，定位到main/res目录
• 将该目录标记为资源根（Resources Root），IDE在构建、运行项目时，会自动把这个目录作为类加载器的根搜索节点
• 配置生效后，即可直接省略main/res/这类冗余前缀，使用images/icon.png、layouts/sample.fxml这类短路径访问资源

替换后的核心代码片段：

// 原全路径"main/res/layouts/sample.fxml"简化为短路径
final Parent root = FXMLLoader.load(
    ClassLoader.getSystemResource("layouts/sample.fxml")
);
// 原全路径"main/res/images/icon.png"简化为短路径
primaryStage.getIcons().add(
    new Image(ClassLoader.getSystemResource("images/icon.png").toString())
);

方案2：代码层面抽离公共路径前缀 #

如果因为项目权限、历史配置等原因不方便调整目录结构，可以在代码中把冗余前缀封装为公共常量，避免每次重复编写长路径：

• 在Main类中定义公共常量存储固定的冗余前缀：

/** 资源路径公共前缀 */
private static final String RESOURCE_BASE = "main/res/";

• 加载资源时通过字符串拼接组合完整路径，业务逻辑中只需要编写资源的相对路径部分即可：

// 加载FXML布局
FXMLLoader.load(ClassLoader.getSystemResource(RESOURCE_BASE + "layouts/sample.fxml"))
// 加载图标资源
new Image(ClassLoader.getSystemResource(RESOURCE_BASE + "images/icon.png").toString())

注意：不要使用本地文件系统的绝对路径（如new File("D:/xxx/icon.png")形式）加载资源，否则项目打包为可执行Jar包后，会直接出现资源找不到的问题，通过类加载器加载资源是跨环境兼容的稳妥方案。

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