@displayname注解在junit 5中支持为测试类和方法设置含中文、空格、符号的可读名称；需确保使用junit 5依赖及正确导入@test，配合@nested等可实现层级化中文描述。

在 JUnit 5 中，@DisplayName 注解可以为测试类和方法设置可读性更强的名称，支持中文、空格、特殊符号等，方便在 IDE（如 IntelliJ IDEA）或测试报告中直观识别。

为测试类添加中文显示名

直接在测试类上加 @DisplayName，整个类在测试运行器里会显示为指定的中文名：

@DisplayName("用户登录功能测试")
public class UserLoginTest {
    // ...
}

为测试方法添加中文描述

在每个 @Test 方法上单独标注，比方法名更清晰表达测试意图：

• @DisplayName("输入空用户名时应提示错误")
• @DisplayName("密码长度不足6位时校验失败")
• @DisplayName("正确账号密码组合可成功登录")

示例：

@Test
@DisplayName("用户名为空时登录失败")
void whenUsernameEmpty_thenLoginFails() {
    // 测试逻辑
}

注意事项和常见问题

确保项目使用的是 JUnit 5（不是 JUnit 4），因为 @DisplayName 是 JUnit 5 引入的特性。Maven 中需引入：

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

<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 { ... }

不复杂但容易忽略细节，只要版本对、导入对、写法对，中文显示就能立刻生效。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南