Beego 通过 github.com/beego/i18n 模块提供开箱即用的多语言支持，基于请求级 goroutine 隔离与配置驱动加载，需在启动阶段调用 i18n.SetMessage() 注册 INI 格式语言文件（如 locale_en-US.ini），并在 controller 的 Prepare() 中设置 b.Lang 实现请求隔离，模板中通过 {{.Tr "key"}} 安全调用翻译函数。
Beego 框架本身不内置 i18n 运行时逻辑，但通过 github.com/beego/i18n 模块提供开箱即用的多语言支持——它不是装饰性功能，而是基于请求级 goroutine 隔离 + 配置驱动加载的轻量方案，适合中低复杂度 Web 应用。
如何注册和加载多语言文件
beego 的 i18n 模块依赖 INI 格式语言包，每个 locale 对应一个独立文件，如 locale_en-US.ini 或 locale_zh-CN.ini。关键点在于：文件路径必须显式传入 i18n.SetMessage()，且调用时机必须早于任何请求处理。
常见错误现象：GetLang() == "" 或翻译始终返回 key 本身（如显示 hi 而非 hello），通常是因为：
-
i18n.SetMessage()没有在应用启动阶段执行，或被放在了 controller 初始化里（太晚） - 文件路径拼错，比如写成
"conf/locale_en-US.txt"（后缀不对）或漏掉conf/前缀 - 配置项
lang::types在app.conf中未定义，导致后续自动探测失败
推荐做法是在 routers/init.go 或 main.go 的 init() 函数中统一加载：
langs := strings.Split(beego.AppConfig.String("lang::types"), "|")
for _, lang := range langs {
if err := i18n.SetMessage(lang, "conf/locale_" + lang + ".ini"); err != nil {
beego.Error("Fail to load locale file: " + err.Error())
}
}
如何在 Controller 中获取并切换当前语言
beego 的 i18n 不依赖全局变量，而是靠嵌入 i18n.Locale 结构体 + 在 Prepare() 方法中主动设置语言来实现请求隔离。这意味着每个 HTTP 请求可拥有独立的 Lang 值，不会互相污染。
典型流程是：
- 从 URL 查询参数（如
?lang=zh-CN）、Cookie（lang键）或Accept-Language头中提取候选语言 - 用
i18n.FindBestMatch()匹配已注册的合法 locale 列表（避免任意字符串注入） - 调用
b.Lang = matchedLang显式赋值，之后b.Tr()才能正确工作
注意：b.Tr("hi") 不会自动 fallback 到默认语言；如果当前 b.Lang 为空或未匹配，它就直接返回 key 字符串。所以务必确保 Prepare() 中完成了有效赋值。
模板中怎么安全使用翻译函数
beego 模板层不内置 Tr 函数，需手动注册。你得在初始化阶段调用 beego.AddFuncMap("i18n", func(key string) string { return ... })，但更稳妥的做法是：在 base controller 的 Prepare() 里把 b.Tr 绑定到 this.Data["Tr"]，然后模板里用 {{.Tr "hi"}}。
容易踩的坑：
- 直接在模板里写
{{Tr "hi"}}—— 模板函数未注册，渲染时报undefined function "Tr" - 传参带空格或特殊字符，比如
{{.Tr "page.title"}}正常，但{{.Tr "page title"}}会查不到（key 必须完全一致） - 没做 HTML 转义，用户提交的翻译内容含
<script></script>，需配合{{.Tr "msg" | html}}
示例（controller）：
func (b *BaseController) Prepare() {
lang := b.GetString("lang")
if lang == "" {
lang = b.Ctx.GetCookie("lang")
}
if matched := i18n.FindBestMatch(lang, []string{"en-US", "zh-CN"}); matched != "" {
b.Lang = matched
b.Ctx.SetCookie("lang", matched, 3600*24*30, "/")
}
b.Data["Tr"] = b.Tr // 绑定到模板上下文
}
为什么 locale 切换后页面没立刻更新
这不是缓存问题，而是 beego 的 i18n 模块本身不处理前端跳转或重定向逻辑。它只负责“当前这次请求”的语言绑定。如果你点击「切换为中文」只是发了个 AJAX 请求更新 Cookie，但没刷新页面或重定向，那后续请求仍可能沿用旧的 Accept-Language 或未携带 lang 参数。
真实项目中要让切换生效，必须做到两点：
- 服务端响应中写入
Set-Cookie: lang=zh-CN（上面代码已体现） - 前端主动跳转或重载，例如
window.location.href = window.location.pathname + "?lang=zh-CN"，否则下一次 GET 请求仍可能走浏览器默认语言探测逻辑
另外，i18n.FindBestMatch() 是严格前缀匹配：传入 zh 不会匹配 zh-CN，必须传 zh-CN 或 zh-TW 这样的完整 tag。这点和某些前端库不同，容易忽略。
