Go x/text/message MatchLanguage 怎样选择输出语言

Go 服务接收国际化请求时，语言通常来自三个地方：用户在账户中保存的偏好、浏览器发送的 Accept-Language，以及服务端必须准备好的默认语言。message.MatchLanguage 适合把这组有序字符串交给 x/text/message 的默认目录匹配器，直接得到一个 language.Tag。实际使用时先固定优先级，再把这个标签同时交给消息打印器和数字格式化逻辑，页面就不会出现中文提示配英文数字的混用。

官方地址：https://pkg.go.dev/golang.org/x/text/message

最稳妥的调用方式是把“用户明确选择、请求头偏好、服务端回退”按这个顺序传入 MatchLanguage，最后用返回的 language.Tag 创建 message.NewPrinter。它负责选择结果，不替代你对输入来源和已加载翻译目录的管理。

先把语言偏好排成稳定顺序

用户在站点里手动选择的语言通常比浏览器默认值更明确，因此放在第一个参数。请求头可能包含多个带权重的 BCP 47 标签，原样作为一个字符串传入即可；最后放一个服务端确实支持的回退语言。空 Cookie 不应占据优先级，否则会把一个没有意义的值混进匹配过程。

调用 MatchLanguage 得到最终标签

下面的处理函数只做选择，不把客户端输入当成最终显示语言。MatchLanguage 没有返回错误值，返回结果是一个可继续传给其他 x/text 包的标签；因此回退值要由服务端明确提供，目录加载也要在请求处理前完成。

package main

import (
    "net/http"

    "golang.org/x/text/message"
)

func chooseLanguage(r *http.Request) string {
    // 用户明确选择优先，其次才使用浏览器偏好，最后固定回退到英文。
    selected := ""
    if cookie, err := r.Cookie("lang"); err == nil {
        selected = cookie.Value
    }
    accept := r.Header.Get("Accept-Language")
    tag := message.MatchLanguage(selected, accept, "en")

    // String 返回规范化后的标签文本，后续 Printer 使用同一个 tag。
    return tag.String()
}

参数顺序就是产品规则：当用户改过站点语言时，浏览器的默认语言不应覆盖它。若业务需要知道“命中了第几个输入”或区分匹配置信度，应改用 golang.org/x/text/language 的 NewMatcher 与 Match；MatchLanguage 只返回最终标签，接口更短，但不会告诉你来源。

用同一个 Tag 创建 Printer

得到标签后，不要在不同模块里重新猜语言。message.NewPrinter(tag) 可以让翻译消息和地区数字格式共享同一选择结果。下面用 SetString 注册一个最小翻译目录，生产环境可以替换成加载好的 catalog。

func localizedSummary(tag language.Tag, count int) string {
    // 目录注册应在服务启动阶段完成，这里只演示调用边界。
    message.SetString(language.English, "items", "%d items")
    message.SetString(language.German, "items", "%d Elemente")

    p := message.NewPrinter(tag)
    // %m 让 Printer 按当前语言查找消息键，%d 也由 Printer 处理地区格式。
    return p.Sprintf(message.Key("items", "%d items"), count)
}

上例的关键不是把每种语言写进请求处理函数，而是让 tag 成为一次交互的共享上下文。用户选择 de 时，文本查找会以德语为目标；如果还要输出金额、日期或数量，应继续使用同一标签初始化相应的 x/text 服务。

回退策略与边界处理

• 回退要真实可用：最后一个参数不要写成任意客户端传入值，应选择已经准备翻译资源的语言。
• 来源要可解释：Cookie、请求头和默认值的优先级由业务定义，不能让不同接口各自采用一套顺序。
• 标签要复用：匹配完成后把 language.Tag 传给消息、数字和排序等本地化组件，避免一条请求出现多种区域规则。
• 不要误解返回值：MatchLanguage 不是“检测客户端是否可信”的校验器，也不返回来源索引；需要诊断信息时使用 language.Matcher。

这个方案适合“只需要一个最终语言标签”的 Web 请求。若页面还要记录用户选择来源、匹配置信度或展示语言切换提示，保留原始输入并在更底层使用 language.NewMatcher，不要把这些额外职责塞进 MatchLanguage。

常见使用疑问

把 Accept-Language 放在第一个参数可以吗

技术上可以，但它会让浏览器偏好压过用户在站点内的明确选择。除非产品规则就是浏览器优先，否则建议把已保存的用户语言放在前面。

MatchLanguage 能返回匹配来源吗

不能。它只返回匹配后的 language.Tag；需要输入索引和置信度时，使用 language.NewMatcher 的 Match 方法。

把输入优先级固定下来，再让同一个 language.Tag 贯穿 Printer 和其他本地化服务，才是 MatchLanguage 的实际价值：选择逻辑集中，回退边界清楚，后续扩展也不会把语言规则拆散。