@DisplayName注解在JUnit 5中支持为测试类和方法设置含中文、空格、符号的可读名称；需确保使用JUnit 5依赖及正确导入@Test，配合@Nested等可实现层级化中文描述。
在 JUnit 5 中，@DisplayName 注解可以为测试类和方法设置可读性更强的名称，支持中文、空格、特殊符号等，方便在 IDE（如 IntelliJ IDEA）或测试报告中直观识别。
为测试类添加中文显示名
直接在测试类上加 @DisplayName，整个类在测试运行器里会显示为指定的中文名：
@DisplayName("用户登录功能测试")
public class UserLoginTest {
// ...
}
为测试方法添加中文描述
在每个 @Test 方法上单独标注，比方法名更清晰表达测试意图：
@DisplayName("输入空用户名时应提示错误")@DisplayName("密码长度不足6位时校验失败")@DisplayName("正确账号密码组合可成功登录")
示例：
立即学习“Java免费学习笔记（深入）”；
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
@Test
@DisplayName("用户名为空时登录失败")
void whenUsernameEmpty_thenLoginFails() {
// 测试逻辑
}
注意事项和常见问题
确保项目使用的是 JUnit 5（不是 JUnit 4），因为 @DisplayName 是 JUnit 5 引入的特性。Maven 中需引入：
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter</artifactId>
<version>5.10.0</version>
<scope>test</scope>
</dependency>
IDE 需要支持 JUnit 5 运行器（IntelliJ 默认支持；Eclipse 可能需要更新 JUnit 插件）。如果显示仍为方法名，请检查是否误用了 org.junit.Test（JUnit 4）——应改用 org.junit.jupiter.api.Test。
配合其他注解增强可读性
可与 @Nested、@DisplayNameGeneration 等搭配使用：
- 用
@Nested分组测试场景，再配@DisplayName命名子类，形成层级化中文描述 - 自定义
DisplayNameGenerator实现统一格式（如自动加前缀“【正向】”“【异常】”）
例如：
@DisplayName("【边界值】手机号格式验证")
@Nested
class PhoneNumberValidationTest { ... }
不复杂但容易忽略细节，只要版本对、导入对、写法对，中文显示就能立刻生效。
