@displayname用于为junit 5测试方法设置可读性强的自定义名称，支持中文、符号、emoji及换行符，可与@nested配合实现分层语义化命名，仅影响显示不改变执行逻辑。
在 Java 的 JUnit 5 中，@DisplayName 是一个非常实用的注解，它能让测试方法在报告中显示更清晰、可读性更强的中文或带符号的名称，而不是默认的驼峰式方法名。这在团队协作、CI/CD 报告查看、甚至日常调试时都特别有用。
如何使用 @DisplayName
只需在测试方法上添加 @DisplayName 注解，并传入你想要展示的字符串即可：
@Test<br>@DisplayName("用户登录成功时应返回 token")<br>void shouldReturnTokenWhenLoginSuccess() {<br> // 测试逻辑<br>}
运行测试后（比如在 IDE 的测试面板或 Maven Surefire 报告中），该方法将不再显示为 shouldReturnTokenWhenLoginSuccess，而是显示为你指定的“用户登录成功时应返回 token”。
@DisplayName 支持的字符和格式
这个注解接受任意合法字符串，包括：
- 中文、空格、标点（如冒号、括号、破折号）
- Emoji 表情（如 ✅、❌、?），部分终端和 IDE 能正常渲染
- 换行符
\n（但多数报告工具会折叠成单行，不建议依赖）
示例：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
@DisplayName("✅ 登录模块：密码错误时返回 401")<br>void whenPasswordWrong_thenStatus401() { ... }
配合 @Nested 实现分组命名
当测试逻辑按场景分层时，@DisplayName 可与 @Nested 结合，让嵌套类也拥有语义化名称：
@Nested<br>@DisplayName("当用户已存在时")<br>class WhenUserExists {<br><br> @Test<br> @DisplayName("更新用户信息应成功")<br> void shouldUpdateUserInfoSuccessfully() { ... }<br><br> @Test<br> @DisplayName("邮箱重复应抛出异常")<br> void shouldThrowExceptionWhenEmailDuplicated() { ... }<br>}
这样在测试报告中会呈现为：“当用户已存在时 › 更新用户信息应成功”，层级关系一目了然。
注意事项和常见问题
使用时需注意以下几点：
- 仅对 JUnit 5 有效（JUnit 4 不支持）
- 不会影响方法执行顺序或测试逻辑，纯属显示优化
- Maven Surefire 插件生成的 HTML 报告默认支持，但旧版本可能需要升级到
2.22.0+ - IDEA 和 VS Code 的测试运行器均原生支持，显示效果良好
- 避免过度堆砌修饰词，保持简洁准确，例如“创建订单：金额为负 → 应拒绝”比“测试负数金额订单创建失败流程验证”更易读
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
