如何在 Java 中通过 Class.getResourceAsStream() 读取 Jar 包内部嵌套的默认资源文件

Class.getResourceAsStream() 是读取 Jar 包内资源最可靠方式，路径以 "/" 开头表示从 classpath 根查找（如 "/images/logo.png"），不加 "/" 则相对当前类包路径查找（如 "config.properties"），必须用正斜杠，且资源须正确打包进 Jar。

在 Ja va 中，Class.getResourceAsStream() 是读取 Jar 包内资源文件最常用、最可靠的方式。关键在于路径写法要符合类加载器的查找规则——它基于类的包结构和类路径（classpath）进行解析，且对 Jar 包完全透明。换句话说，只要你把路径写对了，开发环境和生产环境的行为是一致的，不会出现“本地能读，打包后就读不到”的诡异问题。

路径必须以斜杠开头（绝对路径）或不加斜杠（相对路径）

这是最容易踩坑的地方。如果资源文件与当前类在同一个包下，直接用不带斜杠的名称就好；如果资源在根目录（即和 META-INF/ 同级），则必须用 / 开头。几种常见写法如下：

• MyClass.class.getResourceAsStream("config.properties") → 查找同包下的 config.properties
• MyClass.class.getResourceAsStream("/images/logo.png") → 查找 Jar 根目录下的 images/logo.png
• MyClass.class.getResourceAsStream("data/data.json") → 查找同包下子目录 data/data.json（注意不是 ./data/...）

有个细节：不加斜杠时，路径是基于当前类的包路径来解析的，而不是基于 ClassLoader 的根路径。所以如果你拿不准，建议一律用绝对路径（以 / 开头），这样最不容易出错。

路径中的分隔符必须是正斜杠（/），不能用反斜杠（\）

这一点在 Windows 开发环境下尤其容易中招。Jar 内部资源路径统一使用 /，即便你的操作系统用反斜杠也不行。一旦用了 \，方法会直接返回 null，而且不会有任何异常提示——调试起来非常头疼。

• ✅ 正确："/META-INF/MANIFEST.MF"、"templates/email.ftl"
• ❌ 错误："\templates\email.ftl"、"/templates\email.ftl"

记住：写 Ja va 资源路径时，把它想象成 URL 而不是文件系统路径，就对了。

确保资源文件已正确打包进 Jar

路径写对了，但运行时报 NullPointerException？十有八九是资源根本没被打包进去。编译时，资源文件不会自动复制到输出目录，你需要确认构建工具（Ma ven/Gradle）已经将目标文件纳入 src/main/resources（Ma ven 默认）或对应的资源目录。打包后用 jar -tf your-app.jar | grep "filename" 验证一下，一目了然。

常见遗漏情况包括：

• 文件放在 src/main/ja va 下但未标记为资源目录
• IDE（如 IntelliJ）未启用 “Always compile on build” 或资源拷贝被排除
• 路径名大小写错误（Linux/Jar 文件系统区分大小写，别指望它“不敏感”）

当然，还有一种可能是资源文件在打包时被过滤或忽略了，检查一下 pom.xml 或 build.gradle 中是否有资源过滤配置。

避免使用 File 构造器，始终用 InputStream 处理

很多新手会尝试把 getResourceAsStream() 返回的流转成 File 对象——比如调用 toURI().getPath()——这在 Jar 包中必然失败，因为 URL 协议是 jar: 而不是 file:。正确的做法是直接读取流，用完及时关闭。

try (InputStream is = MyClass.class.getResourceAsStream("/conf/app.conf")) {
    if (is == null) {
        throw new RuntimeException("Resource not found: /conf/app.conf");
    }
    Properties props = new Properties();
    props.load(is);
}

只要路径正确、资源存在、打包无误，getResourceAsStream() 就能在开发环境和 Jar 包中一致工作。这也是为什么它被称为“最可靠方式”——没有之一。