不能用 string 当 context key，因编译期无法校验拼写、跨包同名 key 会覆盖、IDE 无法追踪引用；正确做法是定义私有空结构体 type langKey struct{}，存取均用 langKey{} 实例并做类型断言。
为什么不能用 string 当 context key 存语言标签
直接写 ctx = context.WithValue(ctx, "lang", tag) 看似简单，但会立刻掉进三个坑：编译期无法校验 key 是否拼错（"lang" 和 "lange" 都不报错）、不同包里定义同名 string key 会互相覆盖、IDE 找不到引用位置。Go 的 context.Value 设计本意是传请求级元数据，不是绕过类型系统——语言标签 language.Tag 是结构体，必须用自定义类型作 key 才安全。
怎么定义和使用正确的 context key 类型
声明一个空结构体类型，哪怕只在当前包用一次：
type langKey struct{}
存取时严格用这个类型：
ctx = context.WithValue(ctx, langKey{}, tag)
tag := ctx.Value(langKey{}).(language.Tag)
- 编译器能检查
langKey{}写错就报错 - 即使另一个包也定义了
langKey struct{}，类型也不等价，不会冲突 - VS Code 或 GoLand 点击可跳转到定义，排查链路清晰
HTTP handler 中怎么从 Accept-Language 解析并注入 context
浏览器发来的 Accept-Language: zh-CN,zh;q=0.9,en-US;q=0.8 不能靠 strings.Split 或正则硬切——权重、fallback、标准化都得交给 language.ParseAcceptLanguage。正确流程是：
- 用配置里的
supported_languages构建matcher := language.NewMatcher(supportedTags) tags := language.ParseAcceptLanguage(r.Header.Get("Accept-Language"))- 遍历
tags，对每个调用matchedTag, conf := matcher.Match(tag)，只取conf > language.No的第一个结果 - 没匹配上就 fallback 到配置的
default_language - 最后把选中的
matchedTag存进 context：ctx = context.WithValue(r.Context(), langKey{}, matchedTag)
下游函数怎么安全取用语言标签做翻译
取值时别漏类型断言和空值判断，尤其在中间件或 DB 层可能收不到预期 key：
if tag, ok := ctx.Value(langKey{}).(language.Tag); ok {
printer := localizer.Printer(tag)
msg := printer.Sprintf("login.title")
} else {
// 降级用默认语言，不要 panic
printer := localizer.Printer(language.English)
}
关键点在于：每次调用 localizer.Printer(tag) 应返回新实例（golang.org/x/text/message.Printer 不是并发安全的），绝不能复用全局单例；且所有翻译调用必须走 printer 实例，而非直接查 map 或硬编码字符串。
最容易被忽略的是 matcher.Match 返回的 confidence 值——它可能是 language.No，此时即使 ok == true 也不能当有效匹配用；还有 YAML 文件加载失败时 i18n.LoadMessageFile 返回 error，但不检查就直接调 Localize，会在运行时 panic “no message found”，而错误源头其实在启动阶段。
