Golang中实现Web模板多语言切换需分离语言内容与模板逻辑，通过JSON/YAML存储多语言资源、启动时加载到内存映射、按URL参数/Cookie识别语言、注册模板翻译函数t实现动态渲染。
在Golang中实现Web页面模板的多语言切换，关键在于将语言内容与模板逻辑分离，并根据用户请求动态加载对应语言的文本资源。下面介绍一种实用的国际化（i18n）实践方式，适用于基于 html/template 的Web应用。
使用JSON或YAML存储多语言资源
将不同语言的文本保存在结构化文件中，便于维护和扩展。
例如，创建两个语言包文件：
// i18n/zh.json
{
"welcome": "欢迎访问我们的网站",
"about": "关于我们"
}
// i18n/en.json
{
"welcome": "Welcome to our site",
"about": "About Us"
}
启动时读取这些文件到内存中，构建一个全局的语言映射：
立即学习“go语言免费学习笔记（深入）”；
var translations = make(map[string]map[string]string)
func loadTranslations() {
for _, lang := range []string{"en", "zh"} {
data, _ := ioutil.ReadFile(fmt.Sprintf("i18n/%s.json", lang))
var dict map[string]string
json.Unmarshal(data, &dict)
translations[lang] = dict
}
}
通过URL参数或Cookie识别用户语言偏好
在HTTP处理器中解析用户的语言选择，可以来自URL参数、Accept-Language头或Cookie。
func detectLanguage(r *http.Request) string {
// 优先从URL参数获取
if lang := r.URL.Query().Get("lang"); lang != "" {
return lang
}
// 其次尝试从Cookie读取
if cookie, err := r.Cookie("lang"); err == nil {
return cookie.Value
}
// 默认为英文
return "en"
}
设置语言Cookie的处理函数：
func setLang(w http.ResponseWriter, r *http.Request) {
lang := r.FormValue("lang")
if lang == "zh" || lang == "en" {
http.SetCookie(w, &http.Cookie{
Name: "lang",
Value: lang,
Path: "/",
})
}
http.Redirect(w, r, "/", http.StatusFound)
}
在模板中使用翻译函数
Golang的 html/template 支持自定义函数，我们可以注册一个 t 函数用于查找翻译文本。
func renderTemplate(w http.ResponseWriter, name string, data interface{}, lang string) {
t := template.New(name).Funcs(template.FuncMap{
"t": func(key string) string {
if text, exists := translations[lang][key]; exists {
return text
}
return key // 如果未找到，返回原key作为fallback
},
})
t, _ = t.ParseFiles("templates/" + name + ".html")
t.Execute(w, data)
}
模板中调用方式：
{{ t "welcome" }}
{{ t "about" }}
整合进HTTP处理器
最终在主处理器中组合上述逻辑：
func indexHandler(w http.ResponseWriter, r *http.Request) {
lang := detectLanguage(r)
renderTemplate(w, "index", nil, lang)
}
路由示例：
http.HandleFunc("/", indexHandler)
http.HandleFunc("/setlang", setLang)
基本上就这些。这套方案简单清晰，适合中小型项目。随着语言增多，可进一步封装成独立的i18n包，支持热更新、复数形式、占位符替换等功能。核心思想是：数据分离、动态加载、模板函数驱动。不复杂但容易忽略细节，比如编码问题或缓存机制。
