Go x/text/message 翻译键不存在为什么回退原文

x/text/message 找不到翻译时显示原文，是查找与格式化接口设计的回退行为。普通字符串既是翻译查找键，也是没有匹配消息时使用的格式文本；使用 message.Key 时，可以把稳定消息标识和可读的备用文案分开。出现原文不等于 Printer 没有运行，也不能单凭输出判断翻译是否存在。

官方文档：https://pkg.go.dev/golang.org/x/text/message

先理解原文也是查找键

p.Sprintf("Task is waiting") 会将这个字符串作为消息引用查找；若目录没有可用消息，就按原字符串格式化。它不会自动调用翻译服务，也不会根据英文句子临时生成德文。目录需要由应用登记或由项目的消息生成流程提供。

因此“返回原文”至少可能包含两种情况：确实没有找到消息，或者找到的译文恰好与原文相同。Sprintf 返回的是字符串，没有额外的命中布尔值，不能拿“结果等于输入”当作严格的缺失检测。

用独立目录观察命中与回退

这份完整示例只登记 task.done，故意不登记 task.waiting 及其备用文案。两个引用共用同一个明确绑定的目录和语言，避免把全局注册或语言协商混入最小问题。以下为代码阅读示例，未声称本机执行结果。

package main

import (
    "fmt"
    "golang.org/x/text/language"
    "golang.org/x/text/message"
    "golang.org/x/text/message/catalog"
)

func main() {
    cat := catalog.NewBuilder()
    // 翻译写入独立目录，随后显式绑定给 Printer。
    if err := cat.SetString(language.German, "task.done", "Aufgabe erledigt"); err != nil {
        panic(err)
    }
    p := message.NewPrinter(language.German, message.Catalog(cat))
    hit := p.Sprintf(message.Key("task.done", "Task completed"))
    // 未登记这个标识和备用文案，按回退语义采用可读原文。
    miss := p.Sprintf(message.Key("task.waiting", "Task is waiting"))
    raw := p.Sprintf("Task is waiting") // 普通字符串自身也是查找键。
    fmt.Println(hit)
    fmt.Println(miss)
    fmt.Println(raw)
}

按示例设置，hit 使用已登记的德文；miss 使用 Task is waiting 作为备用文案，raw 也没有登记相应翻译。真实应用若改变目录内容或语言配置，应按实际规则解释结果，不能套用这组演示的结论。

message.Key 的备用文本不只是一个不参与查找的硬编码末端。官方实现会先按 id 查找，未找到时还尝试按 fallback 查找，两者都没有才格式化 fallback。因此，仅缺少 id 并不保证立即看到备用文本原样输出。

定位目录绑定和语言选择

先确认翻译写进了哪个目录。包级 message.SetString 操作初始默认目录；示例使用 cat.SetString 写入独立 Builder，再通过 message.Catalog(cat) 指定给 Printer。注册处与使用处若各自持有不同目录，即使键拼写一致，也可能无法得到预期译文。

然后确认语言来源。示例直接使用 language.German，生产入口可以根据项目支持语言协商，但应记录最终交给 Printer 的标签以及目录可用语言。语言匹配和消息回退有各自规则，不能假设任意偏好标签都存在完整翻译。生成的消息代码也必须实际进入程序依赖并完成其初始化，单独保存翻译文件不会让 Printer 自动扫描它。

最后比较键本身。普通格式文本中的标点、空格或占位符变化会改变查找键。应该登记与调用一致的模板，而不是先把参数拼成整句再查找。即使采用备用模板，其中的格式占位符也要和传入参数相符，回退并不会免除格式化约定。

选择可读原文或稳定消息标识

面向小型、文案较稳定的功能，可以直接以可读原文作为键，缺失时仍有合理展示。文案变化频繁或需要区分相同文字的不同语义时，可使用稳定 id 加备用文案，例如示例中的 task.done。后者增加了消息清单维护成本，却能避免每次调整默认文案都必须更换标识。

若产品要求某种语言必须完整覆盖，回退只能维持可读展示，不能代替翻译覆盖管理。应用可以另外维护键与语言的资源清单，避免依赖展示字符串倒推命中情况。本文只给出目录与引用的组织选择，不需要为这个问题引入云服务、远程翻译或复杂部署。

常见疑问与落地清单

Printf 的 error 会报告缺失翻译吗？其返回错误主要遵循输出写入语义，不能把它当作翻译存在性的通知；Sprintf 更只返回字符串。

把键作为 %s 参数就会翻译吗？普通 %s 是参数格式化。不要把字符串参数和第一参数的消息引用混为一谈；需要翻译字符串参数时，文档另有 %m 语义，应按具体场景明确使用。

能否把原文回退彻底视作故障？取决于产品要求。允许部分翻译的界面可以保留可读 fallback；必须完整覆盖的语言应在资源管理层明确缺失，而不是修改显示字符串掩盖问题。

落地时对齐四项即可：登记目录、Printer 语言、查找键、备用格式模板。先保证它们关系清楚，再决定是否需要稳定 id 和独立目录。

参考：message.Key 文档、Builder.SetString 文档、消息查找实现。