Go语言国际化（i18n）实践：利用go-i18n构建多语言应用

{
  "welcome_message": "Welcome, {{.Name}}!",
  "apple_count": "{0} apple",
  "apple_count_plural": "{count} apples",
  "greeting_formal": "Good morning!"
}

{
  "welcome_message": "欢迎，{{.Name}}！",
  "apple_count": "{0} 个苹果",
  "apple_count_plural": "{count} 个苹果",
  "greeting_formal": "早上好！"
}

package main

import (
    "fmt"
    "github.com/nicksnyder/go-i18n/v2/i18n"
    "golang.org/x/text/language"
    "gopkg.in/yaml.v2" // 或者encoding/json
    "io/ioutil"
    "log"
)

var bundle *i18n.Bundle

func init() {
    bundle = i18n.NewBundle(language.English) // 设置默认语言
    bundle.RegisterUnmarshalFunc("json", json.Unmarshal) // 注册JSON解析函数
    // bundle.RegisterUnmarshalFunc("yaml", yaml.Unmarshal) // 如果使用YAML

    // 加载英文翻译文件
    loadTranslationFile("en.json")
    // 加载中文翻译文件
    loadTranslationFile("zh.json")
}

func loadTranslationFile(filename string) {
    // 实际项目中，文件路径可能需要更严谨的处理
    data, err := ioutil.ReadFile(filename)
    if err != nil {
        log.Fatalf("无法读取翻译文件 %s: %v", filename, err)
    }
    // go-i18n v2 推荐使用 LoadMessageFileBytes
    _, err = bundle.LoadMessageFileBytes(data, filename)
    if err != nil {
        log.Fatalf("无法加载翻译文件 %s: %v", filename, err)
    }
}

func main() {
    // 模拟用户请求的语言偏好，例如从HTTP请求头获取
    userLangs := []string{"zh", "en"} // 用户偏好中文，其次英文

    // 创建本地化器，go-i18n会根据bundle中已加载的语言和userLangs进行匹配
    localizer := i18n.NewLocalizer(bundle, userLangs...)

    // 1. 翻译不带变量的简单文本
    greeting := localizer.MustLocalize(&i18n.LocalizeConfig{
        MessageID: "greeting_formal",
    })
    fmt.Println("Greeting:", greeting) // 输出: 早上好！ (如果用户语言偏好是中文)

    // 2. 翻译带变量的文本
    welcome := localizer.MustLocalize(&i18n.LocalizeConfig{
        MessageID:    "welcome_message",
        TemplateData: map[string]interface{}{"Name": "Go"},
    })
    fmt.Println("Welcome:", welcome) // 输出: 欢迎，Go！

    // 3. 翻译带复数规则的文本
    // 数量为1
    apple1 := localizer.MustLocalize(&i18n.LocalizeConfig{
        MessageID:   "apple_count",
        PluralCount: 1,
        TemplateData: map[string]interface{}{
            "0": "1", // 对应 {0} 占位符
        },
    })
    fmt.Println("Apple count (1):", apple1) // 输出: 1 个苹果

    // 数量为2
    apple2 := localizer.MustLocalize(&i18n.LocalizeConfig{
        MessageID:   "apple_count", // 仍然使用同一个MessageID
        PluralCount: 2,
        TemplateData: map[string]interface{}{
            "count": "2", // 对应 {count} 占位符
        },
    })
    fmt.Println("Apple count (2):", apple2) // 输出: 2 个苹果

    // 4. 处理未找到翻译的情况
    notFound := localizer.MustLocalize(&i18n.LocalizeConfig{
        MessageID: "non_existent_message",
        DefaultMessage: &i18n.Message{
            ID:    "non_existent_message",
            Other: "Default fallback message",
        },
    })
    fmt.Println("Not Found:", notFound) // 输出: Default fallback message
}