Golang国际化支持方案实现多语言版本切换-Golang-PHP中文网

go标准库不支持运行时全局切换语言环境，time.format和fmt.printf始终输出英文；多语言必须显式构造per-request的message.printer并提前注册翻译资源。

golang国际化支持方案实现多语言版本切换

Go 标准库不支持运行时全局切换语言环境，time.Format 和 fmt.Printf 永远输出英文，硬编码且不可覆盖——这不是配置问题，是设计如此。所谓“多语言切换”，必须显式构造 per-request 的 message.Printer，并提前注册翻译资源。

为什么 time.Now().Format("2006年1月2日") 总是显示英文月份？

Go 的 time.Format 内部直接写死英文字符串（如 "January"、"Monday"），完全忽略系统 LC_TIME 或 LANG；os.Setenv("LANG", "zh_CN") 对它毫无作用。这不是 bug，是标准库的明确取舍：避免依赖 OS locale 带来的不可控行为。

所有日期/数字/复数格式化都需通过 golang.org/x/text/message + language.Tag 显式调用
message.Printer 是无状态对象，必须按请求新建，不能复用或缓存跨请求
未注册翻译时，p.Printf 默认回退到源字符串（通常是英文），不会 panic 也不会报错

如何为 HTTP 请求动态创建 message.Printer？

从 Accept-Language 头提取语言标签，构造对应 message.Printer，这是最常见也最安全的做法。

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

用 language.ParseAcceptLanguage(r.Header.Get("Accept-Language")) 解析，返回有序的 []language.Tag
取第一个有效 tag（如 language.Zh），传给 message.NewPrinter(tag)
不要在 init() 中调用 message.SetDefault()——它只影响未指定 tag 的 Printer，且不可撤销
若需 fallback 到中文，可手动构造：tag := language.MustParse("zh-CN")，而非依赖解析失败后的兜底

翻译文本怎么注册才不会漏？

message.Catalog 必须在程序启动时一次性注册全部翻译，否则运行时调用 p.Printf 会静默回退到英文。

注册方式：catalog.SetString(language.Zh, "Hello, %s!", "你好，%s！")
同一个 key 在不同语言下可注册多次，但必须确保 key 完全一致（包括空格、标点）
推荐把所有翻译集中放在一个 init() 函数里，或用 go:embed 加载 JSON 文件后批量注入
注意：注册顺序无关，但未注册的 key 永远不会触发 error，只会输出原文——这容易被忽略

用户语言偏好存在哪？绝对别放全局变量

语言是请求级状态，不是应用级配置。用包级变量（如 var CurrentLang language.Tag）会导致并发请求互相污染。

HTTP 场景：存入 context.Context，handler 开头解析并 ctx = context.WithValue(ctx, langKey, tag)
Gin 等框架：用 c.Set("lang", tag)，后续 handler 用 c.MustGet("lang").(language.Tag)
CLI 工具：通过 flag 解析后，作为参数传给各业务函数，禁止写入 global struct
切忌在中间件里修改 http.Request 的字段——Request 是不可变结构体，改了也没用

真正的复杂点不在“怎么切”，而在“切完之后所有字符串输出都得走 message.Printer”。漏掉一处 fmt.Println 或硬编码的 time.Now().Format，就会导致界面上混杂中英文字——这种问题上线后极难定位。