理解Java中的文件路径与工作目录
在Java中，当我们使用new File(String path)构造函数并传入一个相对路径时，JVM会根据当前的“工作目录”（Current Working Directory, CWD）来解析这个路径。工作目录是程序启动时所在的目录，它决定了相对路径的基准点。不同的运行环境或启动方式，可能会导致工作目录的不同。
考虑以下项目结构：
filePathTesting ┣ test ┃ ┣ TestCard.java ┃ ┣ TestCardGame.java ┃ ┗ valid5PlayersPack.txt ┗ src ┣ App.java ┣ Card.java ┗ CardGame.java
其中，valid5PlayersPack.txt是一个测试资源文件。
在src/CardGame.java中有一个验证文件内容的静态方法：
立即学习“Java免费学习笔记（深入）”；
public static boolean isValidPackFile(String packLocation, int numPlayers) {
File file = new File(packLocation);
if (file.exists() && file.isFile()) {
// ... 文件读取和内容验证逻辑 ...
} else {
System.out.println("ERROR: Pack file does not exist");
return false;
}
}当程序直接运行时（例如，通过java App命令或IDE的“运行”功能），如果其工作目录是filePathTesting，那么传入"test/valid5PlayersPack.txt"作为packLocation，File对象会正确解析到filePathTesting/test/valid5PlayersPack.txt。
JUnit测试环境下的路径问题
然而，在JUnit测试环境中，情况可能变得复杂。JUnit测试通常由构建工具（如Maven、Gradle）或IDE（如VS Code、IntelliJ IDEA）的测试运行器启动。这些测试运行器可能不会将项目根目录（filePathTesting）作为默认工作目录。
例如，在test/TestCardGame.java中有一个测试方法：
@Test
public void testIsValidPackFileValidFile() throws IOException {
int numPlayers = 5;
String filePath = "valid5PlayersPack.txt"; // 注意这里传入的是相对路径
System.out.println(new File(".").getAbsolutePath()); // 打印当前工作目录
assertTrue("Valid file not recognised as valid", CardGame.isValidPackFile(filePath, numPlayers));
}当运行此测试时，如果System.out.println(new File(".").getAbsolutePath());输出的是类似filePathTesting_dba1f5ce/.这样的路径，这表明测试运行器的工作目录是filePathTesting_dba1f5ce，而不是项目根目录filePathTesting。
在这种情况下，当测试方法调用CardGame.isValidPackFile("valid5PlayersPack.txt", ...)时，File file = new File("valid5PlayersPack.txt");会在filePathTesting_dba1f5ce/valid5PlayersPack.txt处查找文件。由于实际文件位于filePathTesting/test/valid5PlayersPack.txt，且测试运行器的工作目录不是项目根目录，因此文件将无法找到，导致file.exists()返回false。
尝试各种相对路径（如../test/valid5PlayersPack.txt、src/test/valid5PlayersPack.txt等）之所以失败，正是因为它们都是基于一个错误的或不一致的工作目录进行解析的。
解决方案：配置测试运行器的工作目录
解决此问题的核心在于确保JUnit测试运行器的工作目录与我们期望的基准目录一致，通常是项目的根目录。
以VS Code的Java扩展为例，可以通过修改settings.json文件来配置测试运行器的工作目录。
-
打开settings.json：
- 在VS Code中，按下Ctrl+,（或Cmd+,）打开设置。
- 在搜索框中输入settings.json，然后点击“编辑 in settings.json”链接。
-
添加或修改java.test.config配置： 在settings.json中添加或修改java.test.config部分，将workingDirectory设置为${workspaceFolder}。${workspaceFolder}是一个VS Code变量，代表当前打开的工作区（即项目根目录）。
{ // 其他配置项... "java.test.config": { "workingDirectory": "${workspaceFolder}" } }
通过此配置，当JUnit测试运行时，其工作目录将被设置为filePathTesting（即项目的根目录）。此时，如果测试方法中传入的文件路径是"test/valid5PlayersPack.txt"，File对象就能正确地解析到filePathTesting/test/valid5PlayersPack.txt，从而找到文件。
最佳实践与注意事项
明确工作目录： 在处理文件路径时，尤其是在测试环境中，始终要清楚当前程序的工作目录是什么。使用System.out.println(new File(".").getAbsolutePath());是一个很好的调试工具。
-
资源文件管理：
-
对于测试资源： 建议将测试相关的资源文件放在src/test/resources目录下（遵循Maven/Gradle标准）。这样，可以通过ClassLoader.getResource()或ClassLoader.getResourceAsStream()方法来加载，这些方法不依赖于文件系统的工作目录，而是从类路径中查找资源。
例如：
// 在测试方法中 InputStream is = TestCardGame.class.getClassLoader().getResourceAsStream("valid5PlayersPack.txt"); // 或者如果文件在子目录中，例如 src/test/resources/data/valid5PlayersPack.txt // InputStream is = TestCardGame.class.getClassLoader().getResourceAsStream("data/valid5PlayersPack.txt"); if (is != null) { try (BufferedReader reader = new BufferedReader(new InputStreamReader(is))) { // ... 读取文件内容 ... } } else { // 处理资源未找到的情况 } - 对于应用程序运行时资源： 同样推荐使用ClassLoader.getResourceAsStream()来加载应用程序内部的资源，因为这能确保在JAR包部署后资源仍能被找到。
-
对于测试资源： 建议将测试相关的资源文件放在src/test/resources目录下（遵循Maven/Gradle标准）。这样，可以通过ClassLoader.getResource()或ClassLoader.getResourceAsStream()方法来加载，这些方法不依赖于文件系统的工作目录，而是从类路径中查找资源。
例如：
避免硬编码绝对路径： 除非是系统级配置或特定场景，否则应尽量避免在代码中硬编码绝对文件路径，因为这会降低代码的可移植性。
使用java.nio.file.Path API： Java NIO 2的Path API提供了更强大和灵活的文件路径操作能力，包括路径的解析、组合、规范化等，有助于编写更健壮的文件处理代码。
通过理解工作目录的原理并正确配置测试环境，可以有效避免Java测试中常见的FileNotFoundException问题，确保测试的稳定性和可靠性。
