@TempDir 是 JUnit 5.4+ 提供的自动管理临时目录的注解，支持字段和方法参数两种用法，要求 JUnit 5.4+、junit-jupiter 依赖及 JUnit Platform 运行环境，仅支持 Path 类型，测试结束后自动清理。
Java 单元测试中使用 @TempDir 是 JUnit 5.4+ 提供的便捷方式，用于自动创建和清理临时目录，避免手动管理路径、权限或残留文件。它比 Files.createTempDirectory 更安全、更简洁，且与测试生命周期绑定。
✅ 前提条件：确保环境支持
需要满足以下任一条件：
- JUnit 5.4 或更高版本（推荐 5.10+）
- Maven 项目中已引入
junit-jupiter（不是旧版junit-vintage） - 测试类运行在 JUnit Platform 上（IDE/构建工具默认支持）
✅ 正确声明 @TempDir 字段或参数
@TempDir 可用于两种位置，语义略有不同：
- 作为测试类字段：每个测试方法执行前创建新目录，测试结束后自动删除（推荐用于多个测试共用临时目录逻辑）
- 作为测试方法参数：每个测试方法单独注入一个独立临时目录（更隔离，推荐大多数场景）
示例（方法参数形式）：
@Test
void shouldWriteAndReadFile(@TempDir Path tempDir) throws IOException {
Path file = tempDir.resolve("data.txt");
Files.writeString(file, "hello");
String content = Files.readString(file);
assertEquals("hello", content);
// tempDir 及其下所有内容会在该测试结束后自动删除
}
✅ 注意事项与常见问题
使用时需留意以下关键点：
-
@TempDir只支持java.nio.file.Path类型，不支持java.io.File - 不能用于静态字段或构造函数参数
- 若测试方法抛出异常导致提前退出，
@TempDir仍会保证清理（JUnit 内部通过AfterEach机制保障） - 临时目录默认由系统决定位置（如
/tmp/junitXXXXXX），不可指定路径名；如需自定义前缀，可配合Files.createTempDirectory("prefix")手动管理（但失去自动清理）
✅ 替代方案对比（何时不用 @TempDir）
某些场景下可能需要其他方式：
- 需要跨 JVM 或持久化临时数据 → 改用明确路径 + 显式
deleteOnExit()或测试后手动清理 - 测试依赖外部进程读写该目录 →
@TempDir的自动清理可能导致竞态，建议改用固定测试目录并确保每次清空 - JUnit 5.3 或更早 → 必须用
Files.createTempDirectory(null)+@AfterEach删除
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
