如何使用Golang实现多语言支持_结合模板输出不同语言内容

陆砚码

2026-10-12 • 👁 0人浏览过

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

请求头选择最匹配的语言，提升用户体验。 php版微信js-sdk支付接口类 php版微信js-sdk支付接口类下载立即学习 “ 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

可提升专业度。

相关文章