核心是消息注册、语言匹配、上下文注入三步：message.loadmessagefile仅注入catalog，printer需显式绑定tag；go-i18n/v2要求active.zh-cn.json命名及{"description","translation"}结构；accept-language必须用language.parseacceptlanguage解析并matcher匹配。
Go 语言做多语言，核心不是“选哪个库”，而是“消息怎么注册、语言怎么匹配、Printer 或 Localizer 怎么用”——三者错一个，localize("welcome") 就返回空字符串或原始 key。
为什么 message.LoadMessageFile 加载后还是输出英文？
常见错误是以为调一次 message.LoadMessageFile("zh-CN.toml") 就全局生效了。实际上：message.Printer 实例必须显式绑定已加载的语言数据，且每个实例只认自己初始化时传入的 language.Tag。
- 加载文件本身不自动注册到任何
Printer；它只是把翻译注入到默认message.Catalog，但这个 catalog 不会被未指定 tag 的 printer 使用 - 必须确保
message.LoadMessageFile("zh-CN.toml")中的文件名与language.Make("zh-CN")完全一致（大小写、连字符、顺序），否则静默失败 - 文件内容需以
[[messages]]开头，每条是id = "value"形式，id不能含空格或中文 - 若用
message.SetString(language.Make("zh-CN"), "welcome", "欢迎")，后续创建message.NewPrinter(language.Make("zh-CN"))才能生效
go-i18n/v2 中 active.zh-CN.json 为什么总加载失败？
不是路径或权限问题，大概率是命名或结构不符合 BCP 47 + JSON Schema 规范。bundle.ParseFS 静默忽略所有不合规文件，不会报错。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 文件名必须是
active.zh-CN.json，不能是zh.json、zh_CN.json、cn.json或active-zh-CN.json - JSON 内容外层必须是对象，每个 key 对应一个 message ID，值必须是
{"description": "...", "translation": "..."}，缺description字段也会被跳过 - 只加载前缀为
active.的文件，translate.或inactive.不会读 - 若用
os.DirFS("./locales")，文件路径必须是./locales/active.zh-CN.json，不能少一层目录
Accept-Language 解析为什么不能 strings.Split？
浏览器发来的 Accept-Language: zh-CN,zh;q=0.9,en-US;q=0.8,en;q=0.7 是带权重、可嵌套、需归一化的语言标签序列，不是简单逗号分隔字符串。
- 手动
strings.Split会丢掉q值，导致优先级错乱；还会把zh-Hans当作和zh-CN不兼容，实际 matcher 能归一化识别 - 必须用
language.ParseAcceptLanguage(r.Header.Get("Accept-Language"))得到标准化、排序后的候选列表 - 匹配前要先构建白名单：
supported := []language.Tag{language.Chinese, language.English}，再用matcher := language.NewMatcher(supported)一次性初始化 - 解析结果建议缓存到
r.Context()，避免每次请求重复调用——ParseAcceptLanguage内部有 map 查找开销
Printer 和 Localizer 到底该不该复用？
两者都不能全局单例，但复用策略完全不同：前者必须 per-request 新建，后者可按需构造。
-
message.Printer持有不可变的language.Tag和格式规则，复用会导致多语言混输出；每个请求拿到匹配后的 tag 后，立刻调message.NewPrinter(tag) -
*i18n.Localizer是轻量对象，可每次请求用bundle.NewLocalizer(tag)创建；但*i18n.Bundle必须全局复用，启动时一次性加载所有active.*.json - 别把
Localizer塞进context.WithValue全链路透传——类型不安全、易漏、难调试；推荐在中间件里生成，作为参数传给 handler 闭包 - 性能敏感场景下，避免频繁新建
Printer：如果注册了上百条翻译，又高频切换语言，考虑预热常用 tag 的Printer缓存（但注意并发安全）
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
