本文档提供了一份关于如何在 Go 语言 Web 应用中实现国际化 (I18n) 的实用教程，重点介绍了使用 go-gettext 库的方法。从环境搭建、代码示例、模板创建到最终部署，本文详细阐述了各个步骤，旨在帮助开发者轻松地将应用翻译成多种语言，从而拓展用户群体。通过本文的学习，你将能够掌握 go-gettext 的基本用法，并将其应用到自己的 Go 项目中。
准备工作
首先，确保你已经安装了 Go 语言环境，并且设置了 GOPATH
环境变量
。 本教程使用 go-gettext 库来实现国际化，所以需要先获取该库。
使用 go-gettext 实现国际化
go-gettext 是一个 Go 语言的 gettext 实现，它允许你使用标准的 gettext 工具链来管理翻译文件。
1. 项目结构
假设你的项目结构如下：
2. 代码实现
在你的 Go 代码中，你需要使用 GetText 函数来标记需要翻译的字符串。以下是一个简单的示例：
代码解释：
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 代码中提取需要翻译的字符串。
-d appname: 指定域名为 appname。
-kGetText: 告诉 xgettext 查找名为 GetText 的函数。
-s: 添加源代码位置信息到 .pot 文件。
-o appname.pot: 指定输出文件为 appname.pot。
4. 创建翻译文件 (.po 文件)
Git
程序猿必备版本控制工具
下载
使用 msginit 工具创建特定语言的翻译文件。 例如，要创建法语 (fr_FR) 的翻译文件：
-l fr_FR: 指定语言为法语 (fr_FR)。
-o french.po: 指定输出文件为 french.po。
-i appname.pot: 指定输入文件为 appname.pot。
5. 编辑翻译文件
打开 french.po 文件，并编辑需要翻译的字符串。 例如：
将 msgstr 的值修改为对应的法语翻译。
6. 生成二进制翻译文件 (.mo 文件)
使用 msgfmt 工具将 .po 文件转换为二进制的 .mo 文件。
-c: 检查翻译文件中的错误。
-v: 显示详细的输出信息。
-o locale/fr_FR/LC_MESSAGES/appname.mo: 指定输出文件为 locale/fr_FR/LC_MESSAGES/appname.mo。
7. 部署
确保你的项目目录结构如下：
注意事项：
locale 目录应该位于你的项目根目录下。
locale 目录下的子目录结构应该是 语言代码/LC_MESSAGES/域名.mo。 例如，法语的翻译文件应该位于 locale/fr_FR/LC_MESSAGES/appname.mo。
8. 运行
现在，当你访问你的应用程序时，它应该显示法语的 "Oui."。
总结
本教程介绍了如何使用 go-gettext 库在 Go 语言 Web 应用中实现国际化。 通过使用标准的 gettext 工具链，你可以轻松地管理翻译文件，并将其应用到你的项目中。 记住，国际化是一个持续的过程，你需要不断地更新你的翻译文件，以确保你的应用程序能够正确地显示各种语言。
go get github.com/samuel/go-gettext~appname/
|~app/
| `-app.go
|+github.com/
`-app.yamlpackage 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."))
}xgettext -d appname -kGetText -s -o appname.pot app/app.gomkdir -p locale/fr_FR/LC_MESSAGES
msginit -l fr_FR -o french.po -i appname.pot#: app/app.go:15
msgid "Yes."
msgstr "Oui."msgfmt -c -v -o locale/fr_FR/LC_MESSAGES/appname.mo french.po~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