Go go-i18n 的 MessageID 与 DefaultMessage 有什么区别

在 go-i18n 中，MessageID 和 DefaultMessage 都出现在 i18n.LocalizeConfig 里，但职责不同：前者是“去消息资源里找哪一条”的键，后者是一条完整的默认消息。只需要查已有翻译时使用 MessageID；希望找不到翻译时仍能返回可控文本，则传入 DefaultMessage。

官方地址：https://pkg.go.dev/github.com/nicksnyder/go-i18n/v2/i18n

最容易踩坑的规则是：当 DefaultMessage 已经设置时，LocalizeConfig.MessageID 会被忽略。不要把两个字段写成两个“备用键”，应先决定消息的资源身份，再决定是否需要内联回退内容。

MessageID 负责定位资源

MessageID 通常对应 TOML、JSON 或 YAML 消息文件中的一条记录。它本身不提供展示文本，只告诉 Localizer 应该在当前语言偏好和已加载的 Bundle 中查找什么。

package main

import (
    "fmt"

    "github.com/nicksnyder/go-i18n/v2/i18n"
    "golang.org/x/text/language"
)

func lookupByID() {
    bundle := i18n.NewBundle(language.English)
    localizer := i18n.NewLocalizer(bundle, "zh-CN", "en-US")

    // MessageID 只承担稳定查找键的职责，翻译文本应来自已加载的消息文件。
    text, err := localizer.Localize(&i18n.LocalizeConfig{
        MessageID: "checkout.title",
    })
    if err != nil {
        // 找不到资源时保留错误，避免把缺失翻译误判为成功。
        fmt.Println("localize failed:", err)
        return
    }
    fmt.Println(text)
}

因此，资源文件中的键应稳定、可复用，尽量表达业务消息的身份，例如 checkout.title，而不是把某个语言的原文直接当成键。这样切换语言时，只替换资源内容，不改变调用代码。

DefaultMessage 是完整的回退消息

DefaultMessage 的类型是 *i18n.Message，里面可以包含 ID、模板数据占位符以及 One、Other 等复数形式。它适合在资源文件暂时没有覆盖某个语言，或小型服务不想为一条文案单独维护文件时使用。

func localizeWithFallback(localizer *i18n.Localizer, count int) (string, error) {
    // DefaultMessage 同时携带稳定 ID 和英文回退模板，缺少翻译时仍可返回可读结果。
    return localizer.Localize(&i18n.LocalizeConfig{
        DefaultMessage: &i18n.Message{
            ID:    "cart.items",
            One:   "{{.Count}} item",
            Other: "{{.Count}} items",
        },
        // PluralCount 决定使用 One 还是 Other 等 CLDR 复数形式。
        PluralCount: count,
        TemplateData: map[string]interface{}{
            "Count": count,
        },
    })
}

这里的“默认”是资源未命中后的兜底，不等于永远优先显示 Other。如果 Bundle 里存在对应消息，Localizer 仍会按语言和复数规则使用翻译；只有缺少可用资源时，才回到 DefaultMessage 的内容。

两者同时传入时要看清优先级

不要写出下面这种看似保险、实际语义含混的配置：

config := &i18n.LocalizeConfig{
    MessageID: "wrong.key",
    // DefaultMessage 存在时，上面的 MessageID 不会作为另一个候选键使用。
    DefaultMessage: &i18n.Message{
        ID:    "checkout.title",
        Other: "结算",
    },
}

按照官方 API 说明，MessageID 在 DefaultMessage 已设置时会被忽略。实际调用应把真正的消息身份放到 DefaultMessage.ID，并让它与翻译文件中的 ID 保持一致。否则排查时会出现“明明传了 MessageID，为什么返回的是另一条文案”的错觉。

按场景选择字段

发布前的四项检查

1. 确认消息文件中的键与 MessageID 或 DefaultMessage.ID 完全一致，大小写也不要混用。
2. 确认 Bundle 已注册对应格式的解析器，并在初始化阶段加载目标语言文件。
3. 含模板变量时同步传入 TemplateData；含数量变化时同步传入 PluralCount。
4. 保留 error 处理，不要用一个看似正常的默认空字符串掩盖资源缺失。

小结

MessageID 解决“查哪条消息”，DefaultMessage 解决“查不到时用哪条完整消息兜底”。两者同时出现时，优先理解为 DefaultMessage 接管了消息身份和回退内容，而不是建立两个并列查找路径。把这条边界写进团队封装和代码评审清单，能减少语言文件、复数模板和回退文案之间的隐性不一致。

相关问题

DefaultMessage 只写 Other 可以吗？

可以用于最简单的单一文案，但涉及数量或语言差异时，应补齐相应复数形式和模板数据。

只传 MessageID 找不到翻译会怎样？

Localize 会返回错误；是否继续展示由调用方决定。需要稳定回退时，再使用 DefaultMessage。