JUnit 5 的 @TempDir 注解在测试类字段（非方法参数）上使用时，若 Maven 缺少 Surefire 插件配置，会导致运行时 Path 字段为 null——IDE 可能因内置支持而“侥幸”通过，但终端执行必然失败。

junit 5 的 `@tempdir` 注解在测试类字段（非方法参数）上使用时，若 maven 缺少 surefire 插件配置，会导致运行时 `path` 字段为 `null`——ide 可能因内置支持而“侥幸”通过，但终端执行必然失败。

在 JUnit 5 中，@TempDir 支持两种使用方式：作为测试方法参数（推荐）和作为测试类的实例/静态字段。你当前的代码选择后者：

public class FileTest {
    @TempDir
    private Path tempDir; // ❌ 实例字段 —— 依赖 JUnit Platform 的扩展生命周期管理

    @Test
    public void testConstructor_FileDoesNotExist_ExpectIllegalArgumentException() {
        Path nonExistingFile = Path.of(tempDir.toString(), "NonExistingFile.xls"); // NPE here!
        Assertions.assertFalse(nonExistingFile.toFile().exists());
    }
}

该写法看似简洁，但其正确执行强依赖于 JUnit Platform 的扩展机制被完整激活——而这一机制在 Maven 构建中并非默认启用。关键在于：Maven 的 maven-surefire-plugin 是唯一能桥接 JUnit Jupiter 与 JVM 测试执行环境的标准插件。若 POM 中未显式声明，Maven 将回退到旧版 Surefire（如 2.x），它仅原生支持 JUnit 4，对 JUnit 5 的扩展（如 @TempDir 字段注入、@BeforeEach 生命周期回调等）完全不可见，导致字段未被注入而保持 null。

✅ 正确解决方案：在 pom.xml 中显式配置 maven-surefire-plugin 3.0.0+（推荐 3.2.5 或更高稳定版）：

<build><plugins><plugin><artifactid>maven-surefire-plugin</artifactid><version>3.2.5</version><configuration><!-- 可选：启用详细日志便于调试 --><trimstacktrace>false</trimstacktrace></configuration></plugin></plugins></build>

⚠️ 注意：junit-jupiter-engine 和 junit-jupiter-api 依赖本身不包含执行引擎绑定逻辑；它们仅提供注解与 API。真正负责扫描 @TempDir 字段、触发临时目录创建、并在每个测试方法前后注入/清理路径的，是 Surefire 插件加载的 JUnit Platform Launcher。

? 验证修复效果：
执行 mvn clean test 后，应看到类似日志：

[INFO] --- maven-surefire-plugin:3.2.5:test (default-test) @ file-test ---
[INFO] Using auto-detected provider org.junit.platform.surefire.provider.JUnitPlatformProvider

这表明 JUnit Platform 已被正确识别，@TempDir 字段将按预期注入（每个测试方法独享独立临时目录）。

? 更佳实践建议：

• 优先使用方法参数形式（@Test void test(@TempDir Path tempDir)），语义更清晰、生命周期更可控，且兼容性更强；
• 若必须用字段（如多测试共用同一临时空间），请确保 @TempDir 字段为 public 或 protected（JUnit 5 要求可访问性），且避免 final；
• 永远为 @TempDir 字段添加空值防护（尤其在调试阶段）：

  @Test
  void testWithFieldTempDir() {
      if (tempDir == null) {
          throw new IllegalStateException("@TempDir field not injected — check Surefire plugin!");
      }
      // ... rest of test
  }

至此，你的测试将在 IDE 和 CLI 环境下行为一致，彻底告别神秘的 NullPointerException。