Java枚举通过私有构造器绑定error_code与message，Python用__init__绑定元组值，Go推荐结构体封装，均应避免外部Map维护以保证一致性。
Java 枚举里怎么存 error_code → message 映射
直接在枚举实例里用构造参数绑定描述文字，是最常用也最安全的做法。别试图用 static Map 外部维护映射，容易漏同步、线程不安全，还破坏枚举的内聚性。
核心思路：每个枚举常量在声明时就初始化自己的 code 和 message 字段，通过私有构造器完成赋值。
public enum ErrorCode {
USER_NOT_FOUND(404, "用户不存在"),
INVALID_TOKEN(401, "令牌无效"),
RATE_LIMIT_EXCEEDED(429, "请求过于频繁");
private final int code;
private final String message;
ErrorCode(int code, String message) {
this.code = code;
this.message = message;
}
public int getCode() { return code; }
public String getMessage() { return message; }
}
- 构造器必须是
private（Java 枚举默认就是，但显式写上更清晰） - 字段建议用
final，避免运行时被意外修改 - 不要把
message设为static—— 每个实例要独立持有自己的描述
Python Enum 中如何让成员自带中文描述
Python 的 Enum 不支持 Java 那种带参构造语法，得靠 __new__ 或者继承 IntEnum/StrEnum（3.11+）来实现字段绑定。
推荐用 __members__ + 类属性方式，简洁且可读性强：
from enum import Enum
class ErrorCode(Enum):
USER_NOT_FOUND = (404, "用户不存在")
INVALID_TOKEN = (401, "令牌无效")
RATE_LIMIT_EXCEEDED = (429, "请求过于频繁")
def __init__(self, code: int, message: str):
self.code = code
self.message = message
- 每个成员赋值为元组，
__init__会自动接收并绑定到实例属性 - 调用
ErrorCode.USER_NOT_FOUND.message直接拿到字符串，无需查表 - 注意：不能用
@property动态计算描述，除非你明确需要延迟加载或国际化逻辑
为什么别用 switch/case 或 if-else 做错误码转描述
硬编码分支逻辑会让错误码和文案散落在多处，新增一个错误码就得改两三个地方：枚举定义、switch 分支、测试用例——漏一处就可能返回空字符串或抛 NullPointerException。
- 枚举自带类型安全，IDE 能自动补全、编译期校验；
switch(ErrorCode)在 Java 14+ 还支持模式匹配，但前提是枚举本身已封装好语义 - 如果描述需要国际化，直接在枚举里加
getMessage(Locale)方法比在外层做Map更易维护> - 序列化时（比如 JSON 输出），若直接暴露枚举名，前端还得额外维护一份映射表；而返回
{ "code": 404, "message": "用户不存在" }就能开箱即用
Go 里用 iota + 结构体模拟枚举描述时的坑
Go 没原生枚举，常见做法是用 iota 定义整型常量，再配个 map[int]string 存描述。但这不是真枚举，容易出现「码存在、描述缺失」或「描述重复覆盖」问题。
更稳妥的方式是定义结构体 + 方法，把码和描述绑死：
type ErrorCode struct {
Code int
Message string
}
func (e ErrorCode) String() string { return e.Message }
var (
USER_NOT_FOUND = ErrorCode{Code: 404, Message: "用户不存在"}
INVALID_TOKEN = ErrorCode{Code: 401, Message: "令牌无效"}
)
- 避免用
map[int]string全局变量：它不会随新常量自动更新，单元测试难 mock，且无法保证 key 一定对应某个合法错误码 - 如果要用
switch匹配，优先匹配结构体变量（如err == USER_NOT_FOUND），而不是只比err.Code—— 防止不同错误码误共享同一描述 - 导出字段名保持小写（如
Code）符合 Go 习惯，但注意 JSON 序列化时需加 tag：json:"code"
实际用的时候，最容易忽略的是错误码和描述的**生命周期一致性**：上线后改文案不算 breaking change，但删掉某个枚举成员或者重用它的 code 值，就可能让旧日志里的错误信息突然变成完全无关的描述。所以只要枚举成员存在，它的 message 就不该变语义——哪怕只是错别字，也该新增成员、标记废弃，而不是就地修改。
