本文详解 Java 程序中 FileNotFoundException 的常见根源——工作目录（working directory）与源码目录的混淆，并提供兼容 IDE 调试与 JAR 打包的健壮资源加载方案。
本文详解 java 程序中 `filenotfoundexception` 的常见根源——工作目录（working directory）与源码目录的混淆，并提供兼容 ide 调试与 jar 打包的健壮资源加载方案。
在 Java 开发中，许多开发者初次遇到 FileNotFoundException 时会困惑：“文件明明和 .java 源文件放在同一目录下，为什么 new File("./input.txt") 就找不到？”关键在于：Java 运行时的“当前工作目录”（Current Working Directory, CWD）并不等同于源文件所在目录。
以 IntelliJ IDEA 为例，默认配置下，程序启动时的工作目录是项目根目录（如 /my-project/），而非 src/ 或 src/main/java/。因此：
- new File("./input.txt") 实际查找的是项目根目录下的 input.txt（即 /my-project/input.txt）；
- new File("src/input.txt") 能成功，是因为它指向了 /my-project/src/input.txt；
- 但该写法不具备可移植性：脱离 IDE 后（如打包为 JAR 运行），src/ 目录通常不存在，路径必然失效。
更本质的问题在于：将资源文件（如 input.txt）直接混入 src/ 是反模式。原因有三：
- 源码目录应仅存放可编译的 .java 文件；
- 构建工具（如 Maven/Gradle）默认不会将 src/ 下非 .java 文件复制到输出目录（如 target/classes/）；
- 导致 JAR 包中缺失资源，File 构造器或 new FileInputStream(...) 在运行时必然失败。
✅ 正确做法：遵循标准构建约定，将资源置于专用资源目录，并通过类加载器访问。
立即学习“Java免费学习笔记（深入）”；
✅ 推荐方案：使用 Class.getResource() / getResourceAsStream()
以 Maven 项目结构为例：
my-project/
├── pom.xml
└── src/
├── main/
│ ├── java/
│ │ └── com/example/Main.java ← 主类
│ └── resources/
│ └── input.txt ← 正确位置！
└── test/
└── ...此时，在 Main.java 中应这样加载：
public class Main {
public static void main(String[] args) throws IOException {
// ✅ 方式1：获取资源 URL（适用于需文件路径的场景，如 ImageIO.read()）
URL resourceUrl = Main.class.getResource("/input.txt");
if (resourceUrl == null) {
throw new RuntimeException("Resource 'input.txt' not found in classpath");
}
File file = new File(resourceUrl.toURI()); // 注意：仅当资源在文件系统中时可用（开发期）；JAR 中会失败！
// ✅ 方式2（更推荐）：直接获取输入流（100% 兼容开发与 JAR）
try (InputStream is = Main.class.getResourceAsStream("/input.txt")) {
if (is == null) {
throw new RuntimeException("Resource 'input.txt' not found in classpath");
}
// 使用 InputStream 读取内容，例如：
String content = new String(is.readAllBytes(), StandardCharsets.UTF_8);
System.out.println(content);
}
}
}⚠️ 关键注意事项：
- getResource("/input.txt") 中的前导 / 表示从类路径根目录（即 target/classes/ 或 JAR 根）开始查找；
- 若省略 /（如 getResource("input.txt")），则按相对路径解析（相对于 Main.class 所在包路径），易出错，不推荐；
- getResourceAsStream() 返回 InputStream，无需关心资源物理位置（文件系统 or JAR 内部），是生产环境首选；
- 切勿对 getResource() 返回的 URL 调用 toURI() 后构造 File——JAR 中资源无法映射为 File 对象，会抛 IllegalArgumentException。
✅ 验证与调试技巧
- 在 IDEA 中：确认 src/main/resources 已被标记为 Resources Root（右键 → Mark Directory as → Resources Root）；
- 运行前检查：构建后查看 target/classes/input.txt 是否存在；
- 打包验证：执行 mvn clean package，解压生成的 JAR，确认 input.txt 位于根目录；
- 日志辅助：打印 Main.class.getResource("/") 的路径，直观确认类路径根位置。
总结：解决 FileNotFoundException 的核心不是“改路径”，而是理解工作目录与类路径的区别，并采用面向类加载器的资源定位方式。将资源纳入标准资源目录、统一使用 getResourceAsStream()，即可一劳永逸地实现 IDE 调试、命令行运行、JAR 打包全场景兼容。
