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

Go Web 应用国际化 (I18n) 实践指南

DDD

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

原创

237人浏览过

go web 应用国际化 (i18n) 实践指南

本文档旨在为 Go 语言开发的 Web 应用程序提供一套国际化 (I18n) 的实用策略。重点介绍如何使用 go-gettext 库来实现应用程序的本地化，包括环境配置、代码示例、模板生成、翻译流程以及目录结构等详细步骤，帮助开发者轻松实现多语言支持。

使用 go-gettext 实现国际化

go-gettext 是一个用于 Go 语言的 gettext 实现，可以帮助开发者轻松地将应用程序本地化。以下是如何使用 go-gettext 的步骤：

安装 go-gettext:

首先，需要将 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 函数来标记需要翻译的字符串。由于 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."))
}

登录后复制

生成模板文件 (POT):

使用 xgettext 工具从 Go 代码中提取需要翻译的字符串。注意使用 -k 参数指定 GetText 函数作为关键词，否则 xgettext 将无法识别需要翻译的字符串。

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

登录后复制

创建和编辑翻译文件 (PO):

为目标语言创建翻译文件。例如，要支持法语 (fr_FR)，执行以下命令：

AppMall应用商店

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

查看详情

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

登录后复制

编辑 french.po 文件，填写翻译内容。例如：

# Appname l10n
# Copyright (C) 2023 Your Company
# This file is distributed under the same license as the appname package.
# Your Name, 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\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."

登录后复制

生成二进制翻译文件 (MO):

使用 msgfmt 工具将 PO 文件编译成 MO 文件，这是应用程序实际使用的二进制翻译文件。

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

登录后复制

go-gettext/locale 目录下的内容是测试数据，可以删除。