go-i18n/v2 是最稳的国际化方案，因其支持按请求绑定语言、热重载、cldr规则及严格资源校验；而 golang.org/x/text/message 不支持运行时切换，且易因配置错误导致静默失败。
go-i18n/v2 是目前最稳的选择，别用 golang.org/x/text/message 做运行时切换
它压根不是为动态语言切换设计的：message.NewPrinter 一创建，格式规则就固化了。改 language.Tag 或系统 locale 都没用，printer.Printf("Hello") 还是输出英文——你看到的不是“没切成功”，而是“根本没打算支持”。常见错误现象：注册了翻译但始终 fallback 到源字符串，因为漏了 message.Catalog 绑定；或者以为 reload 文件就能生效，结果静默失败。
真正要的是按请求绑定语言：go-i18n/v2 自带 Bundle 管理、Localizer 实例化、热重载（注意：仅对文件系统有效，embed.FS 中需手动检查 fs.Stat）、复数/RTL/性别等 CLDR 规则支持。它不依赖 x/text 的复杂 API，JSON/TOML 格式也更贴近前端习惯。
资源文件命名和结构必须严格符合 BCP 47 + JSON Schema
错一个字符，bundle.ParseFS 就会静默失败，返回空字符串而非报错。文件名必须是 active.zh-CN.json，不能是 zh.json、zh_CN.json 或 cn.json；路径必须匹配 os.DirFS("./locales") 下的真实层级，比如 ./locales/active.en-US.json。
JSON 内容也必须严格：
-
{"welcome": {"description": "homepage greeting", "translation": "欢迎"}}✅ -
{"welcome": "欢迎"}❌（缺少description和外层对象结构） -
{"welcome": {"msg": "欢迎"}}❌（字段名必须是translation）
只加载 active.* 前缀的文件，inactive.* 会被忽略——这是故意设计，避免误加载未审核翻译。
Accept-Language 解析不能直接信 r.Header.Get("Accept-Language")
原始 header 可能为空、超长、含非法 tag（如 en;q=0.9, fr-XX;q=0.8），甚至触发 panic。正确做法是用 language.ParseAcceptLanguage，它自动排序、过滤无效项、做标准化。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
再配合已注册语言集做安全匹配：
- 先调
language.ParseAcceptLanguage(r.Header.Get("Accept-Language"))得到有序候选列表 - 遍历该列表，用
language.MatchStrings(supportedLangs, candidate.String())查第一个合法匹配 - 没匹配上就 fallback 到默认语言（如
language.Make("en")），别硬 fallback 到en-US
缓存解析结果，避免每次请求都重复调 language.Parse——它不是纯函数，内部有 map 查找开销。
Localizer 不能全局单例，但也不必每次 new —— 用 bundle.NewLocalizer 按需轻量构造
*i18n.Localizer 不是 goroutine-safe 的，不能跨请求复用；但也不该每次请求都重建整个 Bundle（加载成本高）。正确姿势是：全局持有一个预加载好的 *i18n.Bundle，每个请求调一次 bundle.NewLocalizer。
这个操作很轻量，本质是查 map，适合高并发。如果你用 Gin/Echo，推荐中间件里解析语言后，把 localizer 注入 ctx，Handler 里取用即可：
ctx = context.WithValue(ctx, localizerKey, bundle.NewLocalizer(bundle, langTag))
模板渲染时传进去：tmpl.Execute(w, map[string]interface{}{"T": localizer})，模板里写 {{.T "auth.login.title"}} 就行。
最容易被忽略的一点：v2 默认不 fallback，bundle.NewLocalizer 必须显式传入语言列表，比如 []string{langTag, "en"}，否则找不到翻译就直接返回空字符串，而不是退到英文。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
