本文详解VS Code环境下Java程序因相对路径错误导致FileNotFoundException的典型原因与修复方法，重点说明如何正确指定JSON文件路径以确保FileReader成功加载资源。
本文详解vs code环境下java程序因相对路径错误导致`filenotfoundexception`的典型原因与修复方法，重点说明如何正确指定json文件路径以确保`filereader`成功加载资源。
在Java开发中，尤其是使用VS Code配合Maven或标准目录结构时，java.io.FileNotFoundException 是读取外部资源（如 userData.json）时最常见的运行时异常之一。其根本原因并非文件不存在，而是程序当前工作目录（Current Working Directory）与开发者预期的路径不一致。
你的项目结构如下：
Project_Root/ ├── src/ │ └── main/java/com/example/group18/MyClass.java └── userData.json
而代码中却硬编码了绝对路径式写法：
new FileReader("group18/src/main/java/com/example/group18/userData.json")
这会导致两个关键问题：
✅ 路径冗余且错误：userData.json 并不在 src/main/java/... 子目录下，而位于项目根目录；
❌ 依赖运行时工作目录：FileReader("xxx") 使用的是 JVM 启动时的当前工作目录（通常是 Project_Root），而非源码所在位置。VS Code 默认以项目根目录为工作目录运行 Java 程序，因此只需使用相对于该目录的路径即可。
✅ 正确做法（推荐）：
若 userData.json 确实放在项目根目录下，直接使用文件名即可：
private boolean checkData(String username, String password) throws FileNotFoundException {
// ✅ 正确：文件与项目根目录同级，JVM工作目录即为Project_Root
JSONObject jsonObject = new JSONObject(new JSONTokener(new FileReader("userData.json")));
JSONArray jsonArray = jsonObject.getJSONArray("users1");
if (jsonArray.length() > 0) {
JSONObject user = jsonArray.getJSONObject(0);
if (user.getString("username").equals(username) &&
user.getString("password").equals(password)) {
user.put("online", true);
return true;
}
}
return false;
}
⚠️ 注意事项：
- 不要依赖IDE的“右键运行”路径假设：VS Code 的 Java 扩展默认以 workspaceFolder（即项目根）为工作目录，但若通过终端手动执行 java -cp ... MyClass，需确认 pwd 是否为项目根；
- 生产环境慎用 FileReader 读取资源文件：若将来将 userData.json 移入 src/main/resources/，应改用类路径加载方式（如 getClass().getResourceAsStream("/userData.json")），以保证打包成 JAR 后仍可访问；
- 增强健壮性建议：添加空值与异常处理，避免 getJSONArray("users1") 抛出 JSONException；同时建议使用 try-with-resources 管理 FileReader 流（尽管 JSONTokener 内部未强制要求关闭，但符合最佳实践）。
? 总结：解决此类 FileNotFoundException 的核心逻辑是——明确 JVM 当前工作目录，并据此书写正确的相对路径。对于 VS Code + Maven 标准项目，优先将配置文件置于项目根目录并用简洁路径引用；长期维护项目则应统一归入 src/main/resources 并采用类路径加载机制，兼顾开发便捷性与部署可靠性。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
