[golang] 常見的多語系翻譯方案

 1. 使用 go-playground/locales + universal-translator ✅（適用於表單驗證和錯誤訊息）

如果你已經使用了 go-playground/validator/v10，那麼可以搭配 go-playground/locales 和 universal-translator 來進行錯誤訊息翻譯。


安裝

go get github.com/go-playground/locales
go get github.com/go-playground/universal-translator
go get github.com/go-playground/validator/v10


使用範例

package main
​
import (
    "fmt""github.com/go-playground/locales/zh"
    "github.com/go-playground/universal-translator"
    "github.com/go-playground/validator/v10"
    zh_translations "github.com/go-playground/validator/v10/translations/zh"
)

var (
    uni      *ut.UniversalTranslator
    validate *validator.Validate
    trans    ut.Translator
)

type User struct {
    Name  string`validate:"required"`
    Email string`validate:"required,email"`
}

func main() {
    // 設定語系
    zhT := zh.New()
    uni = ut.New(zhT, zhT)
    trans, _ = uni.GetTranslator("zh")


    validate = validator.New()
    _ = zh_translations.RegisterDefaultTranslations(validate, trans)


    // 測試資料
    user := User{Name: "", Email: "not_a_valid_email"}


    err := validate.Struct(user)
    if err != nil {
        // 轉換驗證錯誤
        for _, e := range err.(validator.ValidationErrors) {
            fmt.Println(e.Translate(trans))
        }
    }
}

💡 優點：

  • 易於整合 validator 的錯誤訊息
  • 提供多種語言（如 zh, en, ja 等）
  • 自動翻譯驗證錯誤訊息


2. 使用 nicksnyder/go-i18n/v2 ✅（適用於一般應用程式）

go-i18n 是一個完整的國際化解決方案，支援 .json 或 .toml 格式來管理翻譯內容。


安裝

go get github.com/nicksnyder/go-i18n/v2/goi18n
go get github.com/nicksnyder/go-i18n/v2/i18n


建立翻譯文件

建立 active.zh.json（繁體中文）：

{
    "HelloWorld":"你好，世界！","Greeting":"你好，{name}！"
}

建立 active.en.json（英文）：
{
    "HelloWorld":"Hello, World!","Greeting":"Hello, {name}!"
}


使用範例

package main

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

funcmain() {
    bundle := i18n.NewBundle(language.English)
    bundle.LoadMessageFile("active.en.json")
    bundle.LoadMessageFile("active.zh.json")

    // 選擇語言
    localizer := i18n.NewLocalizer(bundle, "zh")

    // 取得翻譯內容
    hello := localizer.MustLocalize(&i18n.LocalizeConfig{
        MessageID: "HelloWorld",
    })
    fmt.Println(hello) // 你好，世界！

    greeting := localizer.MustLocalize(&i18n.LocalizeConfig{
        MessageID: "Greeting",
        TemplateData: map[string]string{
            "name": "小明",
        },
    })
    fmt.Println(greeting) // 你好，小明！
}

💡 優點：

  • 支援 .json 和 .toml 文件，適合管理大量翻譯
  • 可根據 Accept-Language 自動切換語言
  • 模板變數（{name}）支援



3. 使用 vktec/l10n-go ✅（輕量級）

l10n-go 是一個 超輕量級 的 i18n 方案，適合小型應用。


安裝

go get github.com/vktec/l10n-go


使用範例

package main
import (
    "fmt""github.com/vktec/l10n-go"
)

funcmain() {
    l10n.Set("zh", map[string]string{
        "hello":   "你好",
        "goodbye": "再見",
    })

    l10n.Set("en", map[string]string{
        "hello":   "Hello",
        "goodbye": "Goodbye",
    })

    lang := "zh"// 選擇語言
    fmt.Println(l10n.Get(lang, "hello"))   // 你好
    fmt.Println(l10n.Get(lang, "goodbye")) // 再見
}

優點：

  • 極度輕量
  • 簡單易用



4. 其他方案

  • golang.org/x/text/language：Google 官方 text 包，支援語言偵測與轉換（較底層）
  • Smartling/Smartling-CLI：適用於雲端翻譯（企業級）


總結

解決方案適用場景特色
go-playground/locales + universal-translator表單驗證易與 validator 搭配，支援多語系
nicksnyder/go-i18n一般應用程式JSON/TOML 格式管理翻譯，可根據 Accept-Language 切換
vktec/l10n-go小型專案極簡單，適合靜態翻譯
golang.org/x/text/language進階應用Google 官方語言處理



如果你是處理 表單驗證錯誤，推薦 go-playground/universal-translator。
如果你要 管理大量翻譯，推薦 go-i18n。

留言

張貼留言

這個網誌中的熱門文章

[Kotlin]如何學習Kotlin

學習 Kotlin 主要分為幾個階段，根據你的需求（Android 開發、後端開發、Kotlin Multiplatform 等），可以選擇不同的路徑。下面是 完整的 Kotlin 學習指南 ，適合初學者到進階開發者。 1️⃣ 基礎入門 1.1 安裝 Kotlin 開發環境 你可以在不同的平台使用 Kotlin： ✅ 在線學習 （不需安裝） Kotlin 官方 Playground （適合快速測試代碼） ✅ 本地開發 IntelliJ IDEA （推薦，官方 IDE） Android Studio （如果想學 Android 開發） VS Code （需安裝 Kotlin 插件） 命令行 （需要安裝 JDK 和 Kotlin） 安裝 Kotlin 命令行工具 如果想在命令行運行 Kotlin 代碼，可以安裝 Kotlin 編譯器： sh # macOS/Linux (使用 SDKMAN) curl -s https://get.sdkman.io | bash sdk install kotlin # Windows (使用 Chocolatey) choco install kotlin 測試 Kotlin 是否安裝成功： sh kotlin -version 1.2 Kotlin 語法基礎 📌 推薦資源 Kotlin 官方文檔 Kotlin 官方教程 🔥 基本語法 kotlin fun main () { val name: String = "Kotlin" println( "Hello, $name !" ) // 字符串模板 } ✅ 變量與數據類型 kotlin val immutable: String = "不能改變" // val = 只讀 var mutable: Int = 10 // var = 可變 mutable = 20 ✅ 條件語句 kotlin val age = 18 if (age >= 18 ) { println( "成年人" ) } else { println( "未成年" ) } ✅ 函數 kotlin fun add (a: Int ...
閱讀完整內容

[golang]如何使用 gorm 高效執行批量插入 (可以透過 Create()、CreateInBatches()，或者 原生 SQL 語句 來提升效率)

  方法 1：使用  CreateInBatches() （推薦） CreateInBatches()  是  gorm  提供的批量插入方法，支援設定單批次的筆數，適合大規模資料寫入。 範例 package main import ( "log" "gorm.io/driver/mysql" "gorm.io/gorm" ) type User struct { ID uint `gorm:"primaryKey"` Name string Age int } func main () { dsn := "user:password@tcp(127.0.0.1:3306)/testdb?charset=utf8mb4&parseTime=True&loc=Local" db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{}) if err != nil { log.Fatal( "資料庫連接失敗:" , err) } // 準備批量插入的資料 var users []User for i := 1 ; i <= 1000 ; i++ { users = append (users, User{Name: "User" + string (i), Age: 20 + (i % 10 )}) } // 批量插入，每批 100 筆 if err := db.CreateInBatches(users, 100 ).Error; err != nil { log.Fatal( "批量插入失敗:" , err) } else { log.Println( "批量插入成功！" ) } } 優勢 ： 可控每批插入筆數 ，減少單次 SQL 負擔（如  100  筆一批）。 支援事務 ，避免部分插入失敗導致數據不一致。 限制 ： CreateInBatches()  會執行  多次 SQ...
閱讀完整內容

[Kotlin]Kotlin Multiplatform (KMP) 如何安裝使用和部署

 Kotlin Multiplatform (KMP) 是 JetBrains 推出的跨平台開發技術，允許使用 Kotlin 共享核心業務邏輯，同時為不同平台（如 Android、iOS、桌面和 Web）提供各自的 UI。 1️⃣ 安裝與環境設置 1.1 安裝 Kotlin 和 Gradle KMP 使用 Gradle 作為構建工具，因此需要安裝： Kotlin （通常隨 Gradle 自帶） Gradle （建議使用最新版本） Android Studio （開發 Android 部分） Xcode （開發 iOS 部分） 如果你使用 IntelliJ IDEA 或 Android Studio，這些工具通常已預裝。 1.2 安裝 Kotlin Multiplatform 插件 在 Android Studio 或 IntelliJ IDEA： File → Settings → Plugins 搜索 Kotlin Multiplatform Mobile 點擊 Install 安裝 重啟 IDE 2️⃣ 創建 Kotlin Multiplatform 專案 2.1 使用官方範本 可以使用 Kotlin 官方提供的範本來快速建立 KMP 項目： sh # 使用 KMP 官方範本 curl -s https://get.sdkman.io | bash sdk install kotlin 或直接在 Android Studio 內： File → New → New Project 選擇 Kotlin Multiplatform App 選擇所需的目標平台（Android、iOS、Web、Desktop） 2.2 目錄結構 KMP 項目通常具有以下目錄結構： bash root/ ├── shared/ # 共享代碼（Kotlin） │ ├── src/commonMain/ # 共享業務邏輯（Kotlin） │ ├── src/androidMain/ # Android 相關代碼 │ ├── src/iosMain/ # iOS 相關代碼 │ └── build.gradle.kts # KMP 配置 ├── androidApp/ # Android 專案...
閱讀完整內容