Go x/text/message Sprintf 为什么不同于 fmt.Sprintf 的数字格式

先给结论：fmt.Sprintf 只负责按 Go 的格式动词生成字符串；message.Printer.Sprintf 还会把 Printer 绑定的语言标签带入格式化过程。对于 %d、%f、%e、%g，后者可能使用地区数字规则，所以同一个数字看起来不同是预期行为，不是格式串失效。

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

下面只讨论数字格式和翻译键，不延伸到完整的本地化资源构建。

先看结论：两个 Sprintf 处理的输入不同

fmt.Sprintf(format, args...) 的第一个参数就是格式模板；而 p.Sprintf(key, args...) 的 key 类型是 message.Reference，普通字符串会被当作可查找的消息键。Printer 同时携带语言标签，因此它解决的是“按哪个语言环境呈现”这一层问题。

所以排查时先确认调用对象。只替换导入包，却保留了对语言和消息键的假设，最容易得到“为什么结果不一样”的错觉。

最小配方：先选语言，再格式化数字

把语言匹配和输出拆开，Printer 可以在一个请求或一个渲染组件内复用：

package main

import (
    "fmt"

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

func main() {
    // 使用请求偏好选择语言；最后的 English 作为稳定回退。
    tag := message.MatchLanguage("de", "en")
    p := message.NewPrinter(tag)

    // message 会按 Printer 的语言环境处理数字格式。
    localized := p.Sprintf("金额：%.2f", 1234567.8)
    plain := fmt.Sprintf("金额：%.2f", 1234567.8)
    fmt.Println(tag, localized)
    fmt.Println("fmt:", plain)

    // 显式使用 language.Tag 时，适合服务端已完成语言解析的场景。
    _ = message.NewPrinter(language.German)
}

这里的关键不是把 fmt 删除，而是把“本地化输出”和“机器日志、协议字段”分开。日志、JSON 数字或签名输入通常应继续使用 fmt 或更严格的编码规则，不能因为页面需要本地化就全局替换。

关键差异：格式动词与 # 标志会改变路径

官方文档明确说明：%d、%f、%e、%g 默认走本地化数字格式；加上 # 后会回到 fmt 处理。这个标志适合需要稳定、非地区化表示的局部字段。

// # 让该字段保留 fmt 风格，适合协议片段或可比较文本。
stable := p.Sprintf("%#f", 1234.5)

// 普通 %f 允许 Printer 按语言环境呈现小数格式。
localized := p.Sprintf("%f", 1234.5)

fmt.Println(stable)
fmt.Println(localized)

不要只看小数点：千位分组、数字字符和特定语言的约定都可能变化。若同一字符串同时用于页面和缓存键，建议页面展示值与内部稳定值分别生成。

变体与边界：翻译键、回退和类型不要混用

含文字的格式串会参与翻译查找；如果同一个词在不同语境下含义不同，可以用 message.Key 区分键和回退文本：

// 为同形异义的文案创建稳定键；第二个参数是无资源时的回退。
label := message.Key("archive(verb)", "archive")
text := p.Sprintf(label)
fmt.Println(text)

也可以用 message.SetString 为语言和键注册文本。它适合应用启动时加载小型资源；大型项目则应把资源加载、语言匹配和渲染层分开。当前 package 文档还提示，Printer 主要覆盖数字和已提供专用类型的格式化，不能假设所有内置类型都已经本地化。

最后记住三条边界：

• 需要地区展示时，用 Printer；需要稳定机器文本时，用 fmt 或 #。
• 格式串中有业务文案时，用 Key 管理语义，不要把自然语言直接当永久键。
• 用 MatchLanguage 后保留明确回退，避免用户语言不匹配时输出空白或不可读结果。

常见问题

为什么两边都写了 %.2f，结果仍不一样？ 因为动词相同不代表格式化器相同；Printer 会把语言标签带入数字格式化。

怎样让 message 输出更接近 fmt？ 对需要原样格式化的动词使用 #，或直接把该字段交给 fmt.Sprintf，不要依赖当前语言恰好使用相同的数字规则。