JUnit 5 基础

这一课你将能做到

1. 写出带 @Test 与 AssertJ assertThat 的可运行单元测试类，并读懂失败报告
2. 用 @BeforeEach 准备独立 fixture，保证用例互不污染、顺序无关
3. 用 @ParameterizedTest + @CsvSource / @NullAndEmptySource 覆盖多组边界，并用 @TempDir 处理文件类测试

为什么要学

Spring Boot 3.5 的 spring-boot-starter-test 已内置 JUnit 5（Jupiter）+ AssertJ + Mockito，CodeForge 的 SubmissionServiceTest、RoadmapServiceTest 都跑在这套运行器上。人话：JUnit 是「如何发现并执行测试方法」的框架，断言负责告诉你「期望与实际差在哪」。

不会写 @Test，后面的 Mockito、MockMvc、CI 全都没落脚点。本课只练纯逻辑 / 轻量类的骨架；涉及外部依赖时交给下一课的 Mock。本课示例用判题域的两个小练习类（VerdictTranslator、SubmissionAudit）和一个文件导出练习，全部可直接运行，练的是你日后给 AuthService、SubmissionService 写测试时每天重复的肌肉动作。

先建立图像

JUnit 发现 @Test → 每个方法独立跑一遍
    │
    ├─ @BeforeEach：每个用例前重建「干净舞台」
    ├─ 测试体：Arrange（准备）→ Act（调用）→ Assert（断言）
    └─ @AfterEach（可选）：清理资源

失败时：Surefire / IDE 显示「期望 vs 实际」与堆栈

概念	人话	常见写法
@Test	「这是一个可执行用例」	void 方法名()
断言	「结果必须长这样」	AssertJ assertThat(...)
Fixture	「每个用例的干净舞台」	@BeforeEach
参数化	「同一规则，多组数据」	@ParameterizedTest
@TempDir	「自动建、自动删的临时目录」	注入 Path 字段或参数

优先用 AssertJ（assertThat）而不是 JUnit 自带 assertEquals：失败信息更可读，链式断言更贴业务表达。

跟着做

步骤 1：写第一个测试类

新建练习类 VerdictTranslator.java（把判题状态翻成用户能看懂的文案）：

public class VerdictTranslator {
    public static String translate(String status) {
        if (status == null) {
            return "未知";
        }
        return switch (status) {
            case "pending" -> "排队中";
            case "accepted" -> "通过";
            case "wrong_answer" -> "答案错误";
            case "time_limit_exceeded" -> "超时";
            default -> "未知";
        };
    }
}