Go 应用国际化 (I18n) 教程：基于 go-gettext 的实践

本文档提供了一份关于如何在 Go 语言 Web 应用中实现国际化 (I18n) 的实用教程，重点介绍了使用 go-gettext 库的方法。从环境搭建、代码示例、模板创建到最终部署，本文详细阐述了各个步骤，旨在帮助开发者轻松地将应用翻译成多种语言，从而拓展用户群体。通过本文的学习，你将能够掌握 go-gettext 的基本用法，并将其应用到自己的 Go 项目中。

准备工作

首先，确保你已经安装了 Go 语言环境，并且设置了 GOPATH 环境变量。 本教程使用 go-gettext 库来实现国际化，所以需要先获取该库。

go get github.com/samuel/go-gettext

使用 go-gettext 实现国际化

go-gettext 是一个 Go 语言的 gettext 实现，它允许你使用标准的 gettext 工具链来管理翻译文件。

1. 项目结构

假设你的项目结构如下：

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

2. 代码实现

在你的 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"): 获取法语 (fr_FR) 的翻译目录。
• cat.GetText("Yes."): 获取 "Yes." 对应的翻译字符串。

注意：

由于 Go 语言中下划线 _ 的特殊含义，你不能直接使用 _("String to be translated") 这种简写形式。需要使用 GetText 或其他自定义的函数名。

3. 创建翻译模板 (.pot 文件)

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

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

• -d appname: 指定域名为 appname。
• -kGetText: 告诉 xgettext 查找名为 GetText 的函数。
• -s: 添加源代码位置信息到 .pot 文件。
• -o appname.pot: 指定输出文件为 appname.pot。

4. 创建翻译文件 (.po 文件)

AppMall应用商店

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

56

查看详情

使用 msginit 工具创建特定语言的翻译文件。 例如，要创建法语 (fr_FR) 的翻译文件：

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

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

5. 编辑翻译文件

打开 french.po 文件，并编辑需要翻译的字符串。 例如：

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

将 msgstr 的值修改为对应的法语翻译。

6. 生成二进制翻译文件 (.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: 指定输出文件为 locale/fr_FR/LC_MESSAGES/appname.mo。

7. 部署

确保你的项目目录结构如下：

~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

注意事项：

• locale 目录应该位于你的项目根目录下。
• locale 目录下的子目录结构应该是 语言代码/LC_MESSAGES/域名.mo。 例如，法语的翻译文件应该位于 locale/fr_FR/LC_MESSAGES/appname.mo。

8. 运行

现在，当你访问你的应用程序时，它应该显示法语的 "Oui."。

总结

本教程介绍了如何使用 go-gettext 库在 Go 语言 Web 应用中实现国际化。 通过使用标准的 gettext 工具链，你可以轻松地管理翻译文件，并将其应用到你的项目中。 记住，国际化是一个持续的过程，你需要不断地更新你的翻译文件，以确保你的应用程序能够正确地显示各种语言。

以上就是Go 应用国际化 (I18n) 教程：基于 go-gettext 的实践的详细内容，更多请关注php中文网其它相关文章！