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

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

心靈之曲

发布： 2025-09-26 16:51:01

原创

824人浏览过

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

本文档旨在提供一个基于 go-gettext 库的 Go Web 应用国际化 (I18n) 的实用指南。它将引导你完成设置、代码修改、模板生成、翻译以及最终部署的整个过程，并提供示例代码和详细步骤，帮助你轻松实现应用的本地化。

环境准备与 go-gettext 安装

首先，你需要确保你的 Go 开发环境已经搭建好。然后，安装 go-gettext 库。假设你的项目结构如下：

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

登录后复制

在项目根目录下执行以下命令：

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

登录后复制

这会将 go-gettext 库克隆到你的 github.com 目录下。

代码修改：使用 GetText 函数进行翻译

由于 Go 中下划线 _ 的特殊性，go-gettext 不支持使用 _("String to be translated") 这种简写形式。我们需要使用一个自定义的函数名，例如 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."))
}

登录后复制

在这个例子中，我们首先创建了一个名为 "appname" 的 domain，并指定了 locale 目录为 "locale"。然后，我们获取了 "fr_FR" (法语) 的 catalog。最后，我们使用 cat.GetText("Yes.") 来获取 "Yes." 对应的法语翻译。

注意事项：

gettext.NewDomain 的第一个参数是你的应用名称，第二个参数是存放 locale 文件的目录名。
cat.GetText 函数用于根据当前 locale 获取翻译后的字符串。

生成模板：使用 xgettext

为了提取需要翻译的字符串，我们需要使用 xgettext 工具生成一个 .pot 文件 (Portable Object Template)。

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

登录后复制

参数说明：

AppMall应用商店

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

查看详情

-d appname: 指定 domain 名称为 "appname"。
-kGetText: 告诉 xgettext 查找名为 GetText 的函数。 重要：如果没有这个参数，xgettext 将不会识别 GetText 函数，导致生成空的 .pot 文件。
-s: 添加源代码位置到 .pot 文件中。
-o appname.pot: 指定输出文件名为 appname.pot。
app/app.go: 指定要扫描的 Go 代码文件。

创建和编辑翻译文件

接下来，我们需要为目标语言创建翻译文件。这里以法语 (fr_FR) 为例：

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

登录后复制

参数说明：

mkdir -p locale/fr_FR/LC_MESSAGES: 创建存放翻译文件的目录结构。
msginit -l fr_FR -o french.po -i appname.pot: 根据 .pot 文件初始化法语翻译文件 french.po。

现在，你需要编辑 french.po 文件，将 msgid 对应的字符串翻译成法语。

# Appname l10n
# Copyright (C) 2013 Wombat Inc
# This file is distributed under the same license as the appname package.
# Wombat <<a class="__cf_email__" data-cfemail="d4a3bbb9b6b5a094b1acb5b9a4b8b1fab7bbb9" href="/cdn-cgi/l/email-protection">[email protected]</a>>, 2013.
#
msgid ""
msgstr ""
"Project-Id-Version: appname v0.1\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2013-01-13 11:03+1300\n"
"PO-Revision-Date: 2013-01-13 11:10+1300\n"
"Last-Translator: Rich <<a class="__cf_email__" data-cfemail="80f2e9e3e8c0e5f8e1edf0ece5aee3efed" href="/cdn-cgi/l/email-protection">[email protected]</a>>\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 修改为 msgstr "Oui."。

生成二进制翻译文件

最后，我们需要将 .po 文件编译成 .mo 文件 (Machine Object)，这是 go-gettext 运行时需要加载的二进制文件。

$ 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，并存放到正确的目录下。

最终目录结构

完成以上步骤后，你的项目目录结构应该如下所示：

~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

登录后复制

注意： go-gettext 库的 locale 目录下的内容是测试数据，可以移除。