Go 应用国际化 (I18n) 实践指南：基于 go-gettext-Golang-PHP中文网

Go 应用国际化 (I18n) 实践指南：基于 go-gettext

碧海醫心

发布： 2025-09-26 17:14:01

原创

638人浏览过

go 应用国际化 (i18n) 实践指南：基于 go-gettext

本文档旨在为 Go 语言开发者提供一套基于 go-gettext 库的国际化 (I18n) 解决方案，适用于 Web 应用的本地化。内容涵盖环境配置、代码实现、模板生成、翻译以及部署，通过具体示例，指导开发者完成从零开始的 Go 应用国际化改造。

1. 环境准备

首先，确保你的 Go 项目已经初始化。然后，你需要克隆 go-gettext 库到你的项目中。假设你的项目目录结构如下：

~appname/
 |~app/
 | `-app.go
 |+github.com/
 `-app.yaml

登录后复制

执行以下命令克隆 go-gettext：

$ cd appname
$ git clone git://github.com/samuel/go-gettext.git github.com/samuel/go-gettext

登录后复制

2. 代码实现

在你的 Go 代码中使用 go-gettext 库进行国际化。以下是一个简单的示例：

package app

import (
    "fmt"
    "log"
    "net/http"

    "github.com/samuel/go-gettext"
)

func init() {
    http.HandleFunc("/", home)
}

func home(w http.ResponseWriter, r *http.Request) {
    d, err := gettext.NewDomain("appname", "locale")
    if err != nil {
        log.Fatal("Failed at NewDomain.")
    }

    cat := d.GetCatalog("fr_FR")
    if cat == gettext.NullCatalog {
        log.Fatal("Failed at GetCatalog.")
    }

    fmt.Fprintf(w, cat.GetText("Yes."))
}

登录后复制

说明:

gettext.NewDomain("appname", "locale") 创建一个新的 Gettext 域，appname 是你的应用名称，locale 是存放本地化文件的目录。
d.GetCatalog("fr_FR") 获取法语 (法国) 的 catalog。
cat.GetText("Yes.") 获取 "Yes." 对应的法语翻译。

注意: go-gettext 库不支持 _("String to be translated") 这种简写形式，因为下划线在 Go 语言中有特殊含义。你需要使用 GetText 这样的函数名来包裹需要翻译的字符串。

3. 生成模板文件 (.pot)

使用 xgettext 工具从 Go 代码中提取需要翻译的字符串。

$ xgettext -d appname -kGetText -s -o appname.pot app/app.go

登录后复制

参数说明:

-d appname: 指定域名为 appname。
-kGetText: 指定需要提取的函数名为 GetText (大小写敏感)。
-s: 添加源代码位置信息到 .pot 文件中。
-o appname.pot: 指定输出文件为 appname.pot。

重要: -kGetText 参数是必需的，否则 xgettext 将无法识别 GetText 函数调用，.pot 文件将为空。

4. 创建和编辑翻译文件 (.po)

创建本地化目录和 .po 文件。

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

查看详情

$ mkdir -p locale/fr_FR/LC_MESSAGES
$ msginit -l fr_FR -o french.po -i appname.pot

登录后复制

参数说明:

-l fr_FR: 指定语言为法语 (法国)。
-o french.po: 指定输出文件为 french.po。
-i appname.pot: 指定输入文件为 appname.pot。

编辑 french.po 文件，添加翻译：

# Appname l10n
# Copyright (C) 2023 Your Name
# This file is distributed under the same license as the appname package.
# Your Name <<your_email@example.com>>, 2023.
#
msgid ""
msgstr ""
"Project-Id-Version: appname v0.1\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-10-27 10:00+0000\n"
"PO-Revision-Date: 2023-10-27 10:10+0000\n"
"Last-Translator: Your Name <<your_email@example.com>>\n"
"Language-Team: French\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"

#: app/app.go:15
msgid "Yes."
msgstr "Oui."

登录后复制

将 msgid "Yes." 对应的 msgstr 修改为法语翻译 "Oui."。

5. 生成二进制翻译文件 (.mo)

使用 msgfmt 工具将 .po 文件编译成 .mo 文件。

$ msgfmt -c -v -o locale/fr_FR/LC_MESSAGES/appname.mo french.po

登录后复制

参数说明:

-c: 检查翻译文件语法。
-v: 显示详细信息。
-o locale/fr_FR/LC_MESSAGES/appname.mo: 指定输出文件为 appname.mo。

6. 部署

最终的目录结构应该如下所示：

~appname/
 |~app/
 | `-app.go
 |~github.com/
 | `~samuel/
 |   `~go-gettext/
 |     +locale/
 |     |-catalog.go
 |     |-domain.go
 |     `-mo.go
 |~locale/
 | `~fr_FR/
 |   `LC_MESSAGES/
 |    `-appname.mo
 `-app.yaml

登录后复制

将 appname 部署到你的环境中。访问应用时，如果一切配置正确，你应该看到 "Oui."。

注意事项: