JUnit：Java 测试框架的事实标准

JUnit 是 Java 生态中使用最广泛的单元测试框架，GitHub 上收获 7,027 个 Star。从 1997 年首个版本发布至今，JUnit 经历了多次重大迭代，目前的 JUnit 5 架构已经成为 Java 项目测试的标准配置。

JUnit 最新版本为 6.1.0，发布于 2026 年 5 月 19 日。整个项目分为三个核心模块：JUnit Platform 提供测试执行引擎，JUnit Jupiter 是面向开发者的测试 API，JUnit Vintage 负责兼容 JUnit 4 及更早版本的测试代码。

安装配置

JUnit 通过 Maven 或 Gradle 引入依赖即可使用。Maven 用户在 pom.xml 中添加 groupId 为 org.junit.jupiter、artifactId 为 junit-jupiter 的依赖，版本号填 6.1.0。Gradle 用户在 build.gradle 中配置 implementation “org.junit.jupiter:junit-jupiter:6.1.0”。

核心注解

JUnit Jupiter 提供了一组常用注解：@Test 标记测试方法，@BeforeEach 和 @AfterEach 分别在每个测试前后执行，@BeforeAll 和 @AfterAll 在整个测试类前后执行。@DisplayName 可以为测试方法设置可读名称，@Nested 支持嵌套测试结构，@ParameterizedTest 配合 @ValueSource、@CsvSource 等实现参数化测试。

断言机制

JUnit Jupiter 的断言类位于 org.junit.jupiter.api.Assertions 下，提供 assertEquals、assertTrue、assertThrows 等方法。assertThrows 可以验证异常抛出行为，配合 lambda 表达式使用。多个断言可以放在 assertAll 中批量执行，即使某个断言失败，后续断言依然会继续验证，方便一次性暴露所有问题。

条件执行

JUnit 支持基于条件跳过测试。@EnabledOnOs 跳过指定操作系统，@EnabledIf 配合自定义条件表达式决定是否运行，@Disabled 标记暂不执行的测试。这些注解可以加在方法级别或类级别。

扩展模型

JUnit 5 引入了统一的扩展机制，通过 @ExtendWith 注解注册自定义扩展。扩展点包括 TestInstancePostProcessor、BeforeEachCallback、TestExecutionListener 等，覆盖测试生命周期的各个阶段。第三方库如 Mockito 和 Spring Test 都通过这套机制与 JUnit 集成。

构建方式

项目使用 Gradle Wrapper 构建，需要 JDK 25 环境。执行 ./gradlew build 编译并运行全部测试。生成代码覆盖率报告运行 ./gradlew clean jacocoRootReport，结果输出到 build/reports/jacoco 目录下。

JUnit 集成了 Develocity，提供 Build Scans、Build Cache 和 Predictive Test Selection 功能。Build Cache 默认开启，本地构建可以复用 CI 的任务输出，减少重复编译时间。

赞助商与社区

JUnit 的赞助商包括 JetBrains、Netflix 等企业。项目接受社区贡献，带有 up-for-grabs 标签的 Issue 适合新贡献者认领。测试相关问题可以在 StackOverflow 的 junit5 标签下提问，也可以通过 GitHub Discussions 的 Q&A 分类讨论。

提问，也可以通过 GitHub Discussions 的 Q&A 分类讨论。