name()用于精确匹配、反序列化和稳定标识，返回不可变编译期名称；tostring()用于用户展示和调试，可重写提供可读描述；二者语义不同，不可混用。
在变量处理中，name() 和 toString() 表面都返回字符串，但行为逻辑不同，不能默认视为等价。关键不是“是否一致”，而是“何时该用哪个”。
name() 适合做精确匹配和反序列化
它返回编译期确定的标识符，不可重写、不随环境变化，是唯一可靠的“原始键”。
- JSON 反序列化时，若字段值需严格对应枚举定义名（如
"PENDING"），必须用name()或valueOf()解析 - 数据库字段存的是枚举名（非描述），读取后应调用
Enum.valueOf(字符串)，而非依赖toString()的结果 - 日志追踪、监控指标标签等需要稳定、可索引的字符串时，优先取
name()
toString() 适合面向用户或调试输出
它本意就是提供可读性更强的展示文本，且允许按需定制。
- 页面提示、API 响应 message 字段、异常信息中，应使用
toString()（已重写）返回中文或带格式的描述 - 单元测试中验证“显示内容”时，断言目标应为
toString()结果，而非name() - IDE 调试窗口里看到的默认值就是
toString()，重写后能显著提升排查效率
避免混用导致逻辑错位
同一变量在不同上下文中切换两种方法，容易引发隐性 bug。
- 不要用
toString()的结果去查Enum.valueOf()—— 中文“春季”无法还原成Season.SPRING - 不要在 switch 表达式或 map key 中使用未重写的
toString()，它和name()虽然此时相同，但语义不清、易被后续重写破坏 - 对外暴露的工具方法（如
Status.fromCode(int)）内部应严格区分：code 查 map，name 查 valueOf，description 不参与解析
变量命名与注释要体现意图
代码中出现枚举变量时，通过命名暗示其用途，减少歧义。
- 比如
statusName暗示取自status.name()，用于存储或传输 -
statusLabel或statusDisplay暗示取自status.toString()，用于界面或日志 - 在字段声明或方法参数旁加简短注释，例如
// name(), for persistence
