java中使用@test注解需引入junit 5框架,方法须为public void无参,maven/gradle配置依赖,测试类放src/test/java,配合@beforeeach、@displayname等注解增强控制。

在 Java 中使用 @Test 注解标记测试用例,核心是引入 JUnit 测试框架,并确保方法满足基本要求:必须是 public、无返回值(void)、无参数。
添加 JUnit 依赖
根据项目构建工具选择对应版本。现代项目普遍使用 JUnit 5:
- Maven 项目,在
pom.xml中添加:
<dependency><br><groupid>org.junit.jupiter</groupid><br><artifactid>junit-jupiter</artifactid><br><version>5.10.2</version><br><scope>test</scope><br></dependency>
- Gradle 项目,在
build.gradle中添加:
testImplementation 'org.junit.jupiter:junit-jupiter:5.10.2'
编写带 @Test 的测试方法
测试类通常放在 src/test/java 目录下,类名建议以 Test 结尾,方法名应见名知意:
- 必须用
@Test显式标注 - 方法必须是
public void,不能有参数 - 不推荐使用静态方法或私有方法
示例:
import org.junit.jupiter.api.Test;<br><br>public class CalculatorTest {<br> @Test<br> void shouldAddTwoNumbersCorrectly() {<br> int result = 2 + 3;<br> assert result == 5;<br> }<br>}
运行测试用例
支持多种运行方式:
- IDE 中直接点击方法名旁的绿色三角形(IntelliJ / Eclipse)
- Maven 命令行执行:
mvn test - Gradle 命令行执行:
./gradlew test
注意:JUnit 5 的 @Test 来自 org.junit.jupiter.api.Test,不是旧版的 org.junit.Test,导入时别选错。
常用配套注解(可选但实用)
增强测试控制能力:
-
@BeforeEach:每个@Test方法执行前运行(适合初始化) -
@AfterEach:每个@Test方法执行后运行(适合清理) -
@DisplayName("中文描述"):让测试报告更易读 -
@Disabled("暂不执行"):跳过某个测试(替代注释掉)
例如:
@Test<br>@DisplayName("验证 0 除法抛出异常")<br>void shouldThrowArithmeticExceptionWhenDivideByZero() {<br> assertThrows(ArithmeticException.class, () -> {<br> int x = 10 / 0;<br> });<br>}Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











