@DisplayName是JUnit 5用于提升测试名称可读性的注解，支持中文、空格和emoji，可标注在类或方法上，优先级方法高于类，配合@DisplayNamePattern还能增强参数化测试的表达力。
@DisplayName 是 JUnit 5 提供的轻量但极其实用的注解，它不改变测试逻辑，只提升测试报告、IDE 显示和 CI 日志中测试名称的可读性与业务表达力。默认情况下，JUnit 会用方法名（如 testAdditionWithNegativeNumbers）作为显示名，既冗长又缺乏语义。而加上 @DisplayName 后，测试项在 IntelliJ、Maven Surefire 报告或 Jenkins 测试视图里直接呈现为自然语言描述，一眼就能看懂“测的是什么”。
如何正确使用 @DisplayName
它可标注在测试类或测试方法上，支持中文、空格、emoji 和标点，完全不受 Java 标识符命名规则限制：
- 标注在类上：影响整个测试类在报告中的顶层名称
- 标注在方法上：覆盖该测试方法的默认名称，优先级更高
- 可嵌套使用：例如类用 @DisplayName("用户服务")，方法用 @DisplayName("注册时邮箱已存在应返回409冲突")，层级清晰
常见写法与效果对比
原始写法（难读）：
@Test
void testCalculateTotalPrice_withDiscountAndTax() { ... }
加 @DisplayName 后（直观）：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
@Test
@DisplayName("含折扣与税费的商品总价计算应返回精确到分的结果")
void testCalculateTotalPrice_withDiscountAndTax() { ... }
在 IDEA 的测试窗格中，你会看到完整中文描述；Maven 执行 mvn test 后的 Surefire 报告里也直接显示该描述，无需点开源码。
配合参数化测试增强表达力
当使用 @ParameterizedTest 时，单靠方法名无法区分各组数据的业务含义。此时可结合 @DisplayNamePattern（JUnit 5.8+）动态生成描述：
@ParameterizedTest
@DisplayNamePattern("{index} ➤ {0} + {1} = {2}（整数加法验证）")
@CsvSource({ "2, 3, 5", "0, 0, 0", "-1, 1, 0" })
void add_returnsCorrectSum(int a, int b, int expected) {
assertEquals(expected, calculator.add(a, b));
}
运行后报告中将显示：
1 ➤ 2 + 3 = 5（整数加法验证）
2 ➤ 0 + 0 = 0（整数加法验证）
比编号加数字更易定位问题场景。
注意事项与最佳实践
- 避免纯技术术语堆砌，例如“testAdd_WhenNullInput_ThenThrowNPE”不如“空输入时加法应抛出非法参数异常”易懂
- 长度适中，过长（超80字符）可能在某些终端或报告中被截断，建议控制在两行内
- 不替代断言信息——@DisplayName 说明“测什么”，assertion 的 message 说明“为什么失败”
- 团队可约定风格，比如统一以动词开头（“验证…”“确保…”“当…应…”），保持一致性
