Java枚举应保持name()稳定用于程序逻辑，重写toString()实现国际化；通过ResourceBundle按Locale加载翻译，提供getDisplayName(Locale)方法精准展示，JSON序列化默认用name()确保接口稳定。
Java 枚举的 name() 返回定义时的字面量（如 MONDAY），而 toString() 默认行为与 name() 相同，但可被重写——这正是实现国际化展示的关键突破口。
用 toString() 承载本地化文本，name() 保持程序逻辑稳定
枚举常用于业务状态、类型标识等场景，代码中需用 name() 做 switch、序列化或配置映射，它必须是稳定、无空格、无语言依赖的英文标识；而用户界面需要中文、日文等友好名称。此时不应修改 name()，而应重写 toString() 返回当前 Locale 对应的翻译。
- ✅ 正确做法：在枚举中覆盖
toString()，内部委托给 ResourceBundle 或 MessageSource - ❌ 错误做法：重写
name()（无法做到，且编译器禁止）或用name().toLowerCase()等硬编码模拟翻译
结合 ResourceBundle 实现轻量级多语言支持
无需引入 Spring，纯 JDK 即可实现。为每个枚举类准备属性文件（如 DayOfWeek_zh_CN.properties），键为枚举常量名，值为对应翻译：
MONDAY=星期一<br>WEDNESDAY=星期三<br>SUNDAY=星期日
枚举中通过静态 ResourceBundle 加载并缓存翻译结果：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
public enum DayOfWeek {<br> MONDAY, TUESDAY, WEDNESDAY;<br><br> private static final ResourceBundle BUNDLE =<br> ResourceBundle.getBundle("DayOfWeek", Locale.getDefault());<br><br> @Override<br> public String toString() {<br> return BUNDLE.getString(this.name());<br> }<br>}
按需切换 Locale，避免全局影响
直接依赖 Locale.getDefault() 会受系统/线程影响，不适合 Web 应用。更稳妥的方式是将 Locale 作为上下文参数传入，或通过 ThreadLocal 绑定用户会话语言。例如提供带 Locale 的 getter：
- 添加方法：
public String getDisplayName(Locale locale)，内部调用ResourceBundle.getBundle(..., locale) - 保留
toString()为默认行为（如返回英文），避免日志或调试时出现乱码 - 前端展示统一调用
getDisplayName(userLocale)，确保语言精准匹配
与 Jackson / Spring 集成时注意序列化行为
JSON 序列化默认使用 name()（如 "MONDAY"），这是理想行为——前后端契约稳定。若误配 @JsonValue 指向 toString()，会导致 JSON 输出中文，破坏接口规范。
- Jackson：保持默认，不加
@JsonValue；如需自定义序列化，用@JsonCreator+ 静态 fromName 方法 - Spring MVC：表单绑定自动识别
name()，无需额外配置 - 日志输出建议显式调用
name()，避免 toString() 被国际化干扰排查
