第一个junit 5单元测试只需三步:添加junit-jupiter依赖、在src/test/java下创建以test结尾的测试类、用@test注解标记无参void方法并使用assertequals等断言。

写第一个 JUnit 5 单元测试,三步就能跑起来:加依赖、建测试类、写@Test方法。不需要 main 方法,也不用手动调用,IDE 或 Maven 会自动识别并执行。
添加 JUnit 5 依赖
确保项目能用 @Test 和断言功能,必须引入 junit-jupiter。Maven 项目在 pom.xml 的 <dependencies></dependencies> 中加上:
<dependency></dependency><groupid>org.junit.jupiter</groupid><artifactid>junit-jupiter</artifactid>-
<version>5.11.0</version>(推荐使用当前最新稳定版) <scope>test</scope>
Gradle 项目则在 build.gradle 中写:testImplementation 'org.junit.jupiter:junit-jupiter:5.11.0'。IDE(如 IntelliJ 或 Eclipse)通常会自动识别 src/test/java 为测试源根;若没识别,右键该文件夹 → “Mark as Test Sources Root” 即可。
创建测试类和测试方法
测试类建议放在 src/test/java 下,命名以 Test 结尾(如 CalculatorTest),不需继承任何类,也不强制 public。
- 每个测试方法用
@Test注解标记 - 方法返回类型必须是
void,且无参数、非 static - 静态导入常用断言:
import static org.junit.jupiter.api.Assertions.*; - 典型断言有:
assertEquals(预期值, 实际值)、assertTrue(条件)、assertThrows(异常类型, 执行逻辑)
示例:
import static org.junit.jupiter.api.Assertions.*;
import org.junit.jupiter.api.Test;
class CalculatorTest {
@Test
void testAddition() {
Calculator calc = new Calculator();
assertEquals(5, calc.add(2, 3), "2 + 3 应该等于 5");
}
@Test
void testDivideByZero() {
Calculator calc = new Calculator();
assertThrows(IllegalArgumentException.class, () -> calc.divide(10, 0));
}
}
运行测试
不用写 main,直接运行即可:
- 在 IDE 中,右键测试类或单个 @Test 方法 → “Run ‘xxxTest’”
- Maven 命令行执行:
mvn test(会自动运行所有符合命名规范的测试类) - 调试时也可直接在测试方法内打断点,像普通代码一样调试
绿色进度条表示通过,红色表示失败,并附带具体断言错误信息,便于快速定位问题。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











