Golang Echo框架实现国际化多语言支持-Golang-PHP中文网

accept-language解析必须用language.parseacceptlanguage：手动切分会丢失权重、误判变体，导致静默fallback；文件名须为active.zh-cn.json，json须含description和translation字段，bundle全局单例，localizer每请求新建。

golang echo框架实现国际化多语言支持

Accept-Language 解析必须用 language.ParseAcceptLanguage

浏览器发来的 Accept-Language: zh-CN,zh;q=0.9,en-US;q=0.8 不是普通字符串，手动 strings.Split 或正则提取会丢权重、误判变体（比如把 zh-Hans 当作不兼容），最终静默 fallback 到默认语言，且无任何报错提示。

正确做法是：

调用 language.ParseAcceptLanguage(r.Header.Get("Accept-Language")) 得到标准化、已排序的 []language.Tag
预定义白名单：supported := []language.Tag{language.Chinese, language.English, language.Japanese}
初始化一次 matcher := language.NewMatcher(supported)，别在 handler 里重复 new
匹配时用 matched, _ := matcher.Match(acceptTags...)，返回归一化后的 language.Tag（如 zh-Hans → zh）
header 为空或含非法 tag（如 fr-XX）时，ParseAcceptLanguage 会静默跳过，不会 panic

go-i18n/v2 资源加载对文件名和 JSON 结构极其敏感

bundle.ParseFS 加载失败时不会报错，只会返回空字符串或原始 key —— 这是最常踩的坑，也是线上 debug 成本最高的点。

必须严格满足以下四条：

文件名必须是 active.zh-CN.json（不是 zh.json、zh_CN.json、cn.json、zh-CN.json）
路径必须匹配 os.DirFS("./locales")：文件得放在 ./locales/active.zh-CN.json，少一层或多一层目录都不行
JSON 结构必须含 description 和 translation 字段：{"welcome": {"description": "homepage greeting", "translation": "欢迎"}} ✅；{"welcome": "欢迎"} ❌
只加载 active.*.json 文件，inactive.*.json 被设计为自动忽略，不是 bug

Echo 中间件里每请求新建 *i18n.Localizer

*i18n.Localizer 不是全局单例，也不能复用。它轻量（只是 map 查找），但必须按请求构造，否则并发下语言混用。

Golang Stay Updated

提供最新的 Golang 新闻、社群和值得关注的人。适用于寻找 Go 学习资源、发现新库等。

下载

推荐在 Echo 中间件中完成三件事：

从 c.Request() 解析并匹配出 language.Tag，缓存到 c.Set("lang", tag)
调用全局已初始化的 bundle.NewLocalizer(tag) 得到新实例
封装成闭包函数 T := func(msgID string) string { return localizer.Localize(&i18n.LocalizeConfig{MessageID: msgID}) }，再存入 c.Set("T", T)
不要用 context.WithValue 全链路透传 —— 类型不安全，且 Echo 的 c.Get 更直接
别把 localizer 塞进模板上下文直接调用：模板里应只用 T("auth.login.title")，而非 localizer.Localize(...)