1 概述

原文地址：https://junit.org/junit5/docs/5.10.3/user-guide/
原文作者：Stefan Bechtold / Sam Brannen / Johannes Link / Matthias Merdes / Marc Philipp / Juliette de Rancourt / Christian Stein
文档版本：5.10.3
原创翻译：张欢

本文档的目标是为编写测试的程序员、扩展的作者和引擎的作者以及构建工具和IDE供应商提供全面的参考文档。

本文档也提供PDF下载。

1.1 什么是JUnit 5？

与之前的JUnit版本不同，JUnit 5由来自三个不同子项目的几个不同模块组成。

JUnit 5 = JUnit Platform + JUnit Jupiter + JUnit Vintage

JUnit Platform是JVM上的启动测试框架的基础。它还定义了TestEngineAPI，用于开发在平台上运行的测试框架。此外，该平台还提供了一个控制台启动器，用于从命令行启动平台，以及JUnit平台套件引擎，用于使用平台上的一个或多个测试引擎运行自定义测试套件。流行的IDE（见IntelliJ IDEA、Eclipse、NetBeans和Visual Studio Code）和构建工具（参见Gradle、Maven和Ant）也为JUnit平台提供了一流的支持。

JUnit Jupiter是JUnit 5中用于编写测试和扩展的编程模型和扩展模型的组合。Jupiter子项目提供了一个TestEngine，用于在平台上运行基于Jupiter的测试。

JUnit Vintage提供了一个TestEngine，用于在平台上运行基于JUnit 3和JUnit 4的测试。它要求类路径或模块路径上存在JUnit 4.12或更高版本。

1.2 支持的Java版本

JUnit 5在运行时需要Java 8（或更高版本）。不过，您仍然可以测试使用以前版本的JDK编译的代码。

1.3 获取帮助

在Stack Overflow上询问与JUnit 5相关的问题或在Gitter上与社区聊天。

1.4 入门

1.4.1 下载JUnit工件

要了解哪些工件可供下载并包含在您的项目中，请参阅依赖项元数据。要为您的构建设置依赖项管理，请参阅构建支持和示例项目。

1.4.2 JUnit 5特性

要了解JUnit 5中有哪些功能以及如何使用它们，请阅读本用户指南中按主题组织的相应部分。

• 在JUnit Jupiter中编写测试
• 从JUnit 4迁移到JUnit Jupiter
• 运行测试
• JUnit Jupiter的扩展模型
• 高级主题
  • JUnit平台启动器API
  • JUnit平台测试套件

1.4.3 示例项目

要查看可以复制和试验的完整、可运行的项目示例，junit5-samples仓库是一个不错的起点。junit5-samples仓库包含基于JUnit Jupiter、JUnit Vintage和其他测试框架的示例项目集合。您可以在示例项目中找到合适的构建脚本（例如build.gradle、pom.xml等）。以下链接突出显示了您可以选择的一些组合。

• 对于Gradle和Java，请查看junit5-jupiter-starter-gradle项目。
• 对于Gradle 和 Kotlin，请查看junit5-jupiter-starter-gradle-kotlin项目。
• 对于Gradle 和 Groovy，请查看junit5-jupiter-starter-gradle-groovy项目。
• 对于Maven，请查看junit5-jupiter-starter-maven项目。
• 对于Ant，请查看junit5-jupiter-starter-ant项目。