go 的 golang.org/x/text/message 不支持自动加载语言包，必须显式注册；所有翻译项需在启动时用 setstring 或 loadmessagefile 注入 printer 实例，且文件名、tag、key 格式须严格匹配，否则静默失败。
错误消息不能靠 runtime 自动加载，必须显式注册
Go 的 golang.org/x/text/message 不支持“扫描目录自动加载语言包”。所有翻译项都得在程序启动时，用 message.SetString 或 message.LoadMessageFile 显式注入到某个 *message.Printer 实例中。你以为写个 loadAllLocales() 就能一劳永逸？其实它只是帮你批量调用了注册函数，底层仍是手动绑定。
常见错误现象：printer.Sprintf("user_not_found") 始终返回英文，或 panic 报 no translation found。原因往往是：文件路径错、tag 不匹配、key 名含空格、或注册后没把 printer 传给实际调用处。
- 用
message.LoadMessageFile加载.toml文件时，文件名必须严格对应语言 tag，例如zh-CN.toml对应language.MustParse("zh-CN") -
.toml内容必须以[[messages]]开头，每条是id = "xxx"形式，id只能是 ASCII 字符（不能是"用户未找到"） - 注册前建议用
os.Stat检查文件是否存在，因为LoadMessageFile失败时静默忽略，不报错也不提示
语言 tag 必须提前注册，否则 fallback 静默且不可查
你传了 "zh"，但只注册了 language.SimplifiedChinese；或者客户端发来 Accept-Language: zh-CN;q=0.9, en-US;q=0.8，你却只解析第一个 tag——这些都会导致翻译 fallback 到默认语言，而且没有任何日志或 panic 提示。
真正能落地的做法是：在服务启动时，把所有支持的语言 tag 全部注册进 bundle，并为每个 tag 构建一个独立的 *message.Printer 缓存实例。别指望靠一次 message.NewPrinter(lang) 就能动态兜底。
- 注册时优先用
language.Make("zh-CN")，而不是拼字符串"zh-CN"；避免大小写、连字符遗漏 - 同时注册
language.Chinese和language.SimplifiedChinese，防止zh请求 fallback 失败 - 不要在 handler 中每次请求都新建
*message.Printer，初始化开销随翻译条目线性增长；应预热缓存并按 tag 复用
错误构造必须推迟到有语言上下文的地方
DAO 层、model 层、甚至 service 内部都不该 new 出带翻译逻辑的 error。那里没有 Accept-Language，也没有 request context。错误构造必须卡在 HTTP handler 或 gRPC 方法入口——也就是你能拿到 language.Tag 的最后一道关卡。
典型反模式：return fmt.Errorf("用户 %s 不存在", localizer.Translate("user_not_found", username))。这会让错误链里混入中文，errors.Is(err, ErrUserNotFound) 失效，日志也难排查。
- 定义轻量结构体如
AppError{Code: "user_not_found", Args: []interface{}{username}}，Error()方法只返回Code - 在 handler 中解析出
lang→ 从缓存取对应*message.Printer→ 调用printer.Sprintf(appErr.Code, appErr.Args...) - 未识别的
Code统一 fallback 到"unknown_error"，不尝试查表或 panic
多语言错误不能依赖全局变量或 context.Value 透传 printer
把 *message.Printer 存进 context.WithValue 看似方便，但极易出问题：goroutine 复用 context 导致 printer 错乱；中间件跳过导致 printer 丢失；跨服务序列化后 printer 变 nil。更稳的方式是让错误构造函数显式接收 *message.Printer，强制调用方负责传递。
比如定义 NewUserNotFoundError(id string, p *message.Printer) error，而不是 NewUserNotFoundError(id string) error。这样谁调用谁负责，断链风险立刻可见。
- 禁止在 error 结构体里存
*message.Printer字段——它不是线程安全的，且含内部状态 - 如果用 Gin/Echo，可在 middleware 中解析 language 并生成
*message.Printer，然后通过c.Set("printer", p)注入，但后续每一层都得显式c.Value("printer")断言，不能假设一定存在 - CLI 场景下，language 来自 flag 或环境变量，需在 main 入口就构造好 printer，再传入各 command handler
zh-Hans 却只注册了 zh-CN，或 toml 文件里 key 写成 "user not found"（含空格），都会导致翻译静默失败，且无任何提示。
