Go go-i18n 怎样按数量选择复数翻译模板

如果 Go 程序把“1 个文件”和“2 个文件”先在业务层拼成两条字符串，语言一多，单复数规则就会散落在各处。使用 go-i18n 时，关键迁移点是：把复数文本放进 i18n.Message，调用本地化时把数量传给 LocalizeConfig.PluralCount，由 Localizer 按当前语言选择模板。

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

先把业务层的单复数分支收回 Message

旧写法通常是先判断数量，再选择一段字符串。它的问题不是判断本身，而是每个业务模块都要重复维护规则；当语言标签变化时，判断逻辑和翻译资源也容易脱节。go-i18n 的 Message 可以把同一个消息 ID 的不同复数形式放在一起，Bundle 保存消息和语言对应的复数规则，Localizer 负责查找并渲染。

下面的关系图只解释对象之间的静态职责，不代表一次真实运行截图：

用 Bundle 和 Message 准备复数模板

示例固定使用英文语言标签，便于看清 One 与 Other 的区别。实际项目中，消息文件或其他资源格式也可以装入 Bundle；这里直接构造消息，专注于复数选择本身。

package main

import (
    "fmt"

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

func main() {
    // Bundle 保存默认语言以及消息的复数规则。
    bundle := i18n.NewBundle(language.English)
    localizer := i18n.NewLocalizer(bundle, "en")

    // One 和 Other 属于同一个消息的不同复数模板。
    message := &i18n.Message{
        ID:    "FilesCount",
        One:   "{{.PluralCount}} file",
        Other: "{{.PluralCount}} files",
    }

    // 把默认消息交给 Localizer，后续用 PluralCount 选择模板。
    fmt.Println(localizer.MustLocalize(&i18n.LocalizeConfig{
        DefaultMessage: message,
        PluralCount:    1,
    }))
}

这里没有在 Go 代码里写 if count == 1。One 和 Other 是消息资源的一部分，数量只在本地化请求中传入。若消息 ID 来自已加载的翻译文件，也可以把 MessageID 放进配置，而不是每次构造 DefaultMessage。

PluralCount 负责选择，TemplateData 负责补充字段

迁移时最容易混淆的是两个字段：PluralCount 参与复数形式选择；TemplateData 提供模板里的其他数据。官方 API 还说明，当 TemplateData 为 nil 且设置了 PluralCount 时，模板数据会包含这个复数计数，因此简单消息可以直接写 {{.PluralCount}}。

func localizeFiles(localizer *i18n.Localizer, name string, count int) (string, error) {
    // 显式传入业务字段；PluralCount 仍然只负责复数形式选择。
    return localizer.Localize(&i18n.LocalizeConfig{
        DefaultMessage: &i18n.Message{
            ID:    "PersonFiles",
            One:   "{{.Name}} has {{.Count}} file",
            Other: "{{.Name}} has {{.Count}} files",
        },
        PluralCount: count,
        TemplateData: map[string]interface{}{
            "Name":  name,
            "Count": count,
        },
    })
}

这时 Count 是模板显示用的字段，PluralCount 是语言规则判断用的值。两者现在相同只是常见场景；如果显示值需要格式化，仍应保留一个数值作为复数选择依据，不要用带单位的字符串替代 PluralCount。

从旧写法迁移时检查这四件事

如果是从旧版封装迁移，建议先保留消息 ID 和业务调用边界，只替换“字符串拼接/手写分支”这一层。先验证 1、2、较大数量和项目允许的非整数输入，再扩展到其他语言；不同语言的复数类别不应简单套用英文的两分支假设。

相关问题

只传 PluralCount，不传 TemplateData 可以吗？

可以。简单模板可以使用自动提供的 .PluralCount；如果还要渲染用户名、文件名等字段，就显式传入 TemplateData。

PluralCount 和模板里的 Count 必须同名吗？

不必须。PluralCount 是配置字段，模板里的 Count 是你放入 TemplateData 的业务字段；名称不同也能分别承担选择和显示职责。

所有语言都只需要 One 和 Other 吗？

不应这样假设。示例只用英文说明迁移路径；实际支持哪些复数形式，要根据项目语言和 go-i18n 的规则准备对应消息资源。