本文详解 Java 程序中 FileNotFoundException 频发的根本原因——工作目录（Working Directory）与源码目录（src）混淆，并提供跨环境（IDE 调试、命令行运行、JAR 打包）均可靠的资源加载方案。
本文详解 java 程序中 `filenotfoundexception` 频发的根本原因——工作目录（working directory）与源码目录（src）混淆，并提供跨环境（ide 调试、命令行运行、jar 打包）均可靠的资源加载方案。
在 Java 开发中，一个看似简单却极易踩坑的问题是：明明 input.txt 和 Main.java 位于同一文件夹下，使用 new File("./input.txt") 却抛出 FileNotFoundException。许多开发者误以为“同目录”即指源文件所在路径，实则 Java 运行时依据的是当前工作目录（Current Working Directory），而非源码位置。
工作目录 ≠ 源码目录
以 IntelliJ IDEA 为例，默认配置下，程序启动时的工作目录是整个项目的根目录（即包含 pom.xml 或 .idea/ 的目录），而非 src/ 子目录。因此：
- ✅ new File("src/input.txt") 可能成功 —— 因为项目根目录下存在 src/ 子目录；
- ❌ new File("./input.txt") 失败 —— 因为根目录下并无 input.txt；
- ⚠️ new File("input.txt") 同样失败（./ 是冗余前缀，等价于直接写文件名）。
可通过以下代码验证当前工作目录：
System.out.println("Working directory: " + System.getProperty("user.dir"));运行后你将看到类似输出：/Users/you/my-project，而非 /Users/you/my-project/src。
立即学习“Java免费学习笔记（深入）”；
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
正确做法：使用类路径（Classpath）资源加载
硬编码相对路径（如 "src/input.txt"）会导致部署失败——当项目打包为 JAR 时，src/ 目录不复存在，且文件已嵌入归档内，File 类无法访问 JAR 内部资源。真正健壮的方案是将资源置于类路径（classpath）中，并通过 Class.getResource() 或 Class.getResourceAsStream() 加载。
✅ 推荐结构（Maven 标准布局）
my-project/ ├── pom.xml ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/example/Main.java │ │ └── resources/ ← 正确位置！ │ │ └── input.txt
将 input.txt 放入 src/main/resources/ 后，Maven 构建时会自动将其复制到最终 classpath（如 target/classes/），确保无论在 IDE、java -jar 还是 Spring Boot Fat JAR 中均可访问。
✅ 安全读取示例
// 方式1：获取 URL（适用于需文件元信息或构建 File 对象的场景）
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 和 IDE）
try (InputStream is = Main.class.getResourceAsStream("/input.txt")) {
if (is == null) {
throw new RuntimeException("Resource 'input.txt' not found in classpath");
}
// 使用 BufferedReader / Scanner / Files.readAllBytes(is) 等处理流
String content = new String(is.readAllBytes(), StandardCharsets.UTF_8);
System.out.println(content);
}? 关键细节：getResource("/input.txt") 中的前导 / 表示从 classpath 根开始查找（即 src/main/resources/ 下的文件）；若省略 /（如 "input.txt"），则按相对路径解析（从 Main.class 所在包路径下查找），易出错，故统一用绝对路径风格 /。
注意事项与总结
- 永远避免 new File("xxx") 依赖工作目录：其行为高度依赖运行环境（IDE 设置、Shell 启动位置、容器挂载点），不具备可移植性。
- 资源 ≠ 源码：src/ 是开发期源码目录，不应混放配置或数据文件；src/main/resources/ 才是 Maven/Gradle 官方指定的资源存放位置。
- 优先使用 getResourceAsStream()：它返回 InputStream，天然支持从文件系统、JAR、WAR、模块路径等多种来源读取，是生产级 Java 应用的标准实践。
- 非资源型文件（如用户上传、日志输出）才用 File：此时应明确约定路径（如 System.getProperty("user.home") + "/myapp/data/"），并做好异常与权限校验。
遵循以上原则，你的 Java 程序将彻底告别“文件找得到却读不了”的困扰，实现真正的环境无关与部署可靠。
