Go语言虽无内置i18n支持,但可通过go-i18n库结合template实现多语言渲染:加载JSON语言包、按Accept-Language动态切换本地化器、预翻译数据传入模板或注册T函数在模板内调用,并注意UTF-8编码与CLDR复数规则。

Go 语言本身不内置多语言(i18n)支持,但通过标准库 text/template 或 html/template 配合外部 i18n 库(如 go-i18n)或自定义方案,可以简洁、可靠地实现多语言模板渲染。
使用 go-i18n 管理翻译资源
go-i18n 是社区广泛采用的 Go 多语言工具,支持 JSON 格式的本地化文件、运行时加载、复数规则和占位符插值。
- 安装:
go get github.com/nicksnyder/go-i18n/v2/i18n - 准备语言包(例如
active.en.json和active.zh.json):{ "language": "en", "messages": [ { "id": "welcome", "translation": "Hello, {{.Name}}!" }, { "id": "items_count", "translation": "{{.Count}} item{{if ne .Count 1}}s{{end}}" } ] } - 在程序中加载 bundle 并初始化本地化器:
bundle := i18n.NewBundle(language.English) bundle.RegisterUnmarshalFunc("json", json.Unmarshal) _, _ = bundle.LoadMessageFile("locales/active.en.json") _, _ = bundle.LoadMessageFile("locales/active.zh.json") localizer := i18n.NewLocalizer(bundle, "zh") // 设为中文
在模板中注入本地化器并调用翻译
Go 模板无法直接调用函数对象,需将 *i18n.Localizer 封装为可调用的模板函数,或预先翻译好数据再传入模板。
- 推荐方式:在渲染前完成翻译,保持模板干净。例如:
data := map[string]interface{}{ "WelcomeMsg": localizer.MustLocalize(&i18n.LocalizeConfig{ MessageID: "welcome", TemplateData: map[string]string{"Name": "Alice"}, }), "ItemCount": localizer.MustLocalize(&i18n.LocalizeConfig{ MessageID: "items_count", TemplateData: map[string]int{"Count": 2}, }), } tmpl.Execute(w, data) - 若坚持在模板内翻译(需谨慎),可注册自定义函数:
funcMap := template.FuncMap{ "T": func(msgID string, data ...interface{}) string { cfg := &i18n.LocalizeConfig{MessageID: msgID} if len(data) > 0 { cfg.TemplateData = data[0] } s, _ := localizer.Localize(cfg) return s }, } tmpl := template.New("page").Funcs(funcMap)模板中即可写:{{ T "welcome" (dict "Name" "Bob") }}(需配合text/template的dict辅助函数)
结合 HTTP 请求自动识别语言
根据 Accept-Language 请求头选择最匹配的语言,提升用户体验。
主要特性: 1、支持多种语言 BEES支持多种语言,后台添加自动生成,可为每种语言分配网站风格。 2、功能强大灵活 BEES除内置的文章、产品等模型外,还可以自定义生成其它模型,满足不同的需求 3、自定义表单系统 BEES可自定义表单系统,后台按需要生成,将生成的标签加到模板中便可使用。 4、模板制作方便 采用MVC设计模式实现了程序与模板完全分离,分别适合美工和程序员使用。 5、用户体验好 前台
立即学习“go语言免费学习笔记(深入)”;
- 解析请求头并匹配支持语言:
func getLang(r *http.Request) string { accept := r.Header.Get("Accept-Language") tags, _, _ := language.ParseAcceptLanguage(accept) for _, tag := range tags { if tag.String() == "zh" || tag.String() == "zh-CN" { return "zh" } if tag.String() == "en" || tag.String() == "en-US" { return "en" } } return "en" // 默认 } - 每次请求动态创建 localizer:
lang := getLang(r) localizer := i18n.NewLocalizer(bundle, lang)
模板输出与缓存建议
避免为每种语言重复编译模板;应复用同一份 *template.Template 实例,仅替换翻译后的数据。
- 预编译模板一次(如在
init()中):var pageTpl = template.Must(template.ParseFiles("templates/index.html")) - 按需 localize + 执行,无状态、线程安全:
err := pageTpl.Execute(w, data) // data 已含翻译文本
- 如需高性能,可对高频翻译结果做简单内存缓存(如
sync.Map缓存(msgID, lang, dataKey) → string),但多数场景无需
不复杂但容易忽略:确保 JSON 语言文件编码为 UTF-8,且模板文件也以 UTF-8 保存,避免中文乱码;同时注意复数、性别、词序等语言特性,go-i18n 支持 CLDR 规则,合理使用 Plural 和 Select 可提升专业度。









