5.5 国际化 (i18n)

说明

国际化（Internationalization，简称 i18n）是指使应用程序能够支持多种语言和区域设置。Python 提供了 gettext 模块来实现国际化功能。通过 gettext，可以将程序中的文本翻译成多种语言，并根据用户的语言环境自动切换显示语言。

方法

使用 gettext 模块实现国际化的基本步骤如下：

1. 提取程序中需要翻译的文本。
2. 创建翻译文件（.po 和 .mo 文件）。
3. 在程序中使用 gettext 绑定翻译文件。
4. 根据用户的语言环境加载对应的翻译。

参数说明

• gettext.translation(domain, localedir, languages)：加载翻译文件。
• domain：翻译文件的名称（通常与程序名称相同）。
• localedir：翻译文件所在的目录（默认为 locale）。
• languages：用户的语言环境列表（如 ["zh_CN", "en_US"]）。
• gettext.install(domain, localedir)：将 _() 函数安装到全局命名空间，用于翻译文本。

案例演示

以下是一个完整的示例，展示如何使用 gettext 实现多语言支持。

1. 创建程序文件

创建一个 Python 文件 i18n_demo.py，内容如下：

import gettext
import os
import tkinter as tk

# 设置翻译文件路径
LOCALE_DIR = os.path.join(os.path.dirname(__file__), "locale")
gettext.install("myapp", LOCALE_DIR)

# 创建主窗口
root = tk.Tk()
root.title(_("My Application"))  # 标题需要翻译
root.geometry("300x200")

# 添加标签
label = tk.Label(root, text=_("Hello, World!"))  # 文本需要翻译
label.pack(pady=50)

# 运行主事件循环
root.mainloop()

2. 提取需要翻译的文本

在终端中运行以下命令，提取需要翻译的文本并生成 .pot 文件：

xgettext -d myapp -o locale/myapp.pot i18n_demo.py

3. 创建翻译文件

在 locale 目录下创建语言子目录（如 zh_CN/LC_MESSAGES），并将 .pot 文件复制为 .po 文件。然后编辑 .po 文件，添加翻译内容。

例如，创建
locale/zh_CN/LC_MESSAGES/myapp.po，内容如下：

msgid ""
msgstr ""
"Content-Type: text/plain; charset=UTF-8\n"

msgid "My Application"
msgstr "我的应用程序"

msgid "Hello, World!"
msgstr "你好，世界！"

4. 编译翻译文件

在终端中运行以下命令，将 .po 文件编译为 .mo 文件：

msgfmt locale/zh_CN/LC_MESSAGES/myapp.po -o locale/zh_CN/LC_MESSAGES/myapp.mo

5. 运行程序

在终端中运行程序，并设置语言环境为中文：

LANGUAGE=zh_CN python i18n_demo.py

代码说明

1. gettext.install：
2. 将 _() 函数安装到全局命名空间，用于翻译文本。
3. _("Hello, World!") 会自动根据语言环境返回对应的翻译。
4. 翻译文件：
5. .pot 文件是模板文件，包含需要翻译的文本。
6. .po 文件是翻译文件，包含原文和翻译后的文本。
7. .mo 文件是编译后的二进制文件，供程序使用。
8. 语言环境：
9. 通过设置 LANGUAGE 环境变量，可以指定程序使用的语言。

运行效果

1. 当语言环境为中文时，程序显示中文界面：
2. 标题显示为“我的应用程序”。
3. 标签显示为“你好，世界！”。
4. 当语言环境为英文时，程序显示英文界面：
5. 标题显示为“My Application”。
6. 标签显示为“Hello, World!”。

注意事项

翻译文件路径：

• 确保 locale 目录结构正确，例如：
• locale/
• └── zh_CN/
• └── LC_MESSAGES/
• ├── myapp.po
• └── myapp.mo

语言环境设置：

• 可以通过环境变量 LANGUAGE 或 LANG 设置语言环境。

动态切换语言：

• 如果需要动态切换语言，可以重新加载翻译文件并更新界面。

通过 gettext，可以轻松实现 Tkinter 应用程序的多语言支持，提升国际化能力。