Go语言项目如何实现多语言切换

# locales/templates/active.en.toml
[hello]
descript = "问候语"
other = "Hello {{.Name}}"

[welcome]
descript = "欢迎语"
other = "Welcome to {{.Project}}! Your account has {{.Count}} messages."

[message_count]
descript = "消息数量提示（支持复数）"
one = "You have {{.Count}} message."
other = "You have {{.Count}} messages."

[error_login]
descript = "登录错误提示"
other = "Login failed: {{.Reason}}"

[btn_submit]
descript = "提交按钮文本"
other = "Submit"

[btn_cancel]
descript = "取消按钮文本"
other = "Cancel"

# locales/active.zh.toml
[hello]
descript = "问候语"
other = "你好 {{.Name}}"

[welcome]
descript = "欢迎语"
other = "欢迎来到{{.Project}}！你的账户有{{.Count}}条消息。"

[message_count]
descript = "消息数量提示（支持复数）"
one = "你有{{.Count}}条消息。"
other = "你有{{.Count}}条消息。"

[error_login]
descript = "登录错误提示"
other = "登录失败：{{.Reason}}"

[btn_submit]
descript = "提交按钮文本"
other = "提交"

[btn_cancel]
descript = "取消按钮文本"
other = "取消"

package i18n

import (
    "embed"
    "github.com/go-i18n/go-i18n/v2/i18n"
    "golang.org/x/text/language"
    "gopkg.in/yaml.v3"
)

// 嵌入翻译文件，确保编译后能读取到（关键！避免部署时找不到文件）
//go:embed ../locales/active.*.toml
var localesFS embed.FS

// I18n 多语言实例
var I18n *i18n.Bundle
var localizers map[string]*i18n.Localizer

// Init 初始化多语言
func Init() error {
    // 1. 创建bundle，指定默认语言为英文
    I18n = i18n.NewBundle(language.English)
    // 注册toml文件解析器
    I18n.RegisterUnmarshalFunc("toml", yaml.Unmarshal)
    // 从嵌入的文件系统加载所有翻译文件
    files, err := localesFS.ReadDir("../locales")
    if err != nil {
        return err
    }
    for _, file := range files {
        if file.IsDir() {
            continue
        }
        _, err := I18n.LoadMessageFileFromFS(localesFS, "../locales/"+file.Name())
        if err != nil {
            return err
        }
    }

    // 2. 初始化各语言的localizer（用于实际翻译）
    localizers = make(map[string]*i18n.Localizer)
    // 支持的语言列表，与翻译文件对应
    supportedLangs := []string{"en", "zh", "ja"}
    for _, lang := range supportedLangs {
        localizers[lang] = i18n.NewLocalizer(I18n, lang)
    }

    return nil
}

// Translate 翻译方法
// lang: 目标语言（en/zh/ja）
// key: 翻译项key
// data: 占位符数据（可选）
func Translate(lang, key string, data map[string]interface{}) (string, error) {
    // 若指定语言不支持，默认用英文
    localizer, ok := localizers[lang]
    if !ok {
        localizer = localizers["en"]
    }

    // 执行翻译
    if data == nil {
        return localizer.Localize(&i18n.LocalizeConfig{
            MessageID: key,
        })
    }

    // 带占位符的翻译（支持复数）
    return localizer.Localize(&i18n.LocalizeConfig{
        MessageID:    key,
        TemplateData: data,
        PluralCount:  data["Count"], // 复数场景需传入Count字段
    })
}

package main

import (
    "github.com/gin-gonic/gin"
    "github.com/your-name/go-multilingual-demo/i18n"
    "log"
    "net/http"
)

func main() {
    // 1. 初始化多语言
    err := i18n.Init()
    if err != nil {
        log.Fatalf("多语言初始化失败：%v", err)
    }

    // 2. 初始化Gin
    r := gin.Default()

    // 3. 测试接口：根据lang参数返回不同语言的内容
    r.GET("/greet", func(c *gin.Context) {
        // 获取语言参数（优先级：URL参数 > Header > Cookie > 默认英文）
        lang := c.Query("lang")
        if lang == "" {
            lang = c.GetHeader("Accept-Language")
            // 处理Header中的语言格式，比如"zh-CN,zh;q=0.9"取前面的zh
            if len(lang) > 2 {
                lang = lang[:2]
            }
        }
        if lang == "" {
            lang, _ = c.Cookie("lang")
        }

        // 翻译内容（带占位符）
        hello, _ := i18n.Translate(lang, "hello", map[string]interface{}{
            "Name": "张三",
        })
        welcome, _ := i18n.Translate(lang, "welcome", map[string]interface{}{
            "Project": "Go多语言演示项目",
            "Count":   5,
        })
        messageCount, _ := i18n.Translate(lang, "message_count", map[string]interface{}{
            "Count": 1,
        })
        btnSubmit, _ := i18n.Translate(lang, "btn_submit", nil)

        c.JSON(http.StatusOK, gin.H{
            "hello":         hello,
            "welcome":       welcome,
            "message_count": messageCount,
            "btn_submit":    btnSubmit,
        })
    })

    // 4. 启动服务
    log.Fatal(r.Run(":8080"))
}