目录
[第四步:翻译人员通过Qt 语言家翻译文本](#第四步:翻译人员通过Qt 语言家翻译文本)
[第五步: 运行lrelease生成.qm文件](#第五步: 运行lrelease生成.qm文件)
技术背景
当我们使用Qt开发软件,需要支持多语言切换,以此来实现软件国际化,在介绍之前,我们需要了解下如果没有qt语言家,我们会怎么实现多语言的。
比如在MFC中,通过在定于多个xml文件(每个语言一个xml文件),在xml文件中,为每一个需要支持多语言的字符串定义一个唯一的、固定的ID,并写上对应语言的文本,如下:
XML
<Dlg DlgId="25010">
<IDS ID="1" String="确定" />
<IDS ID="2" String="取消" />
</Dlg>
然后在程序启动或切换语言的时候,根据选择的语言,读取并解析对应的xml文件。此时Qt Linguist提供的是一个 完整、成熟、工业级的国际化解决方案 ,而不仅仅是一个文件格式。它通过强大的工具链将繁琐、易错的手动操作自动化。
核心概念
在开始具体步骤的介绍之前,我们需要认识一下几个核心文件和工具。
1、tr()函数
这是我们需要在代码中使用的函数,用来标记所有需要被翻译的文本,他就像一个记号,告诉qt,这个文本是需要替换成其他语言的。
2、.pro文件
Qt项目的配置文件,我们需要在这里告诉Qt,我们的项目需要支持哪些语言。
3、.ts文件
这是一个基于XML格式的翻译源软件,它由Qt的工具生成,里面包含了所有被tr()函数标记过的原始文本,这个文件是给翻译人员使用的,他们用Qt Linguist工具打开它,然后逐条译文。
4、.qm文件
这是一个已编译的、二进制格式的翻译软件,它是由.ts文件发布生成的,体积更小,速度更快,这个文件是给程序在运行的时候使用的,程序会加载它来查找并显示翻译后的文本
5、lupdate工具
一个命令行工具,他的作用是扫描源代码(.cpp,.h,.ui文件),找出所有被tr()函数标记的字符串,然后生成或更新.ts文件
6、Qt Linguist工具
一个图形界面的翻译软件,翻译人员用它来打开.ts文件,然后方便填写译文。
7、lrelease工具
另一个命令行工具,它的作用是将已经翻译好的.ts文件转换成程序最终使用的二进制.qm文件。
具体步骤
第一步:标记需要翻译文本
我们需要在代码中标记待翻译的字符串,这是最基础也是最重要的一步,需要使用到上面所介绍的tr()函数,如下:
cpp
QLabel *label = new QLabel(tr("Hello World"));
QPushButton *button = new QPushButton(tr("Submit"));
第二步:配置项目文件(.pro)
在标记完待翻译的字符串之后,我们需要告诉Qt,项目需要哪些目标语言,这样lupdate工具会根据这个配置来生成相应语言的.ts文件.
那么要怎么配置.pro文件呢?
如下,在.pro文件中添加一个TRANSLATIONS变量,列出所有需要的.ts文件
cpp
TRANSLATIONS = \
language_zh_CN.ts \
language_fr.ts
这里的ts文件名可以自定义的,但通常需要包含语言简写以便区分。
第三步:运行lupdate生成.ts文件
现在,让lupdate工具自动为我们创建翻译源文件,省去了我们手动创建待翻译文本的XML文件的步骤。

执行完之后,我们在项目目录下便可以看到添加的.ts文件 。
第四步:翻译人员通过Qt 语言家翻译文本
先点击文件->打开文件

选择要进行翻译的语言对应的.ts文件
使用Qt Linguist打开

Qt Linguist提供一个非常友好的界面,他会逐条显示原文,我们只需要再旁边的输入框里填入译
即可,如下

在条框输入译文之后,可以点击工具栏上的"对号"图标(或者按Ctrl+Enter)确认该条翻译完成,如下

第五步: 运行lrelease生成.qm文件
翻译工作完成后,我们需要将.ts文件转换成程序能高效使用的格式。因为.ts文件是xml格式,方便我们阅读和编辑,但是解析慢,体积大。.qm是紧凑的二进制格式,程序加载和查找速度极快,适合在运行中使用,可以减小应用的体积和提高速度。
步骤:在Qt Creator中,点击菜单栏的 "工具" -> "外部" -> "Linguist" -> "发布翻译(lrelease)" 。

执行后,每个.ts文件旁边都会生成一个同名的.qm文件 。
第六步:在程序中加载.qm文件
程序本身不会自动加载翻译文件,我们必须在代码中告诉程序,现在用户选择了什么语言,请加载对应的.qm文件,并进行替换。
cpp
#include "mainwindow.h"
#include <QApplication>
#include <QTranslator> // 1. 包含头文件
#include <QLocale> // 用于获取系统语言
int main(int argc, char *argv[])
{
QApplication a(argc, argv);
// 2. 创建翻译家对象
QTranslator translator;
// 3. 根据当前系统语言加载对应的.qm文件
// 这里假设.qm文件和可执行文件在同一目录下的i18n文件夹中
// 或者你也可以使用Qt资源系统(.qrc)来将.qm文件编译到程序内部
QString lang = QLocale::system().name(); // 例如 "zh_CN"
if (translator.load(":/i18n/language_" + lang)) { // 从资源文件加载
// 4. 安装翻译家到应用程序
a.installTranslator(&translator);
}
MainWindow w;
w.show();
return a.exec();
}
当翻译家对象成功加载了翻译文件,这里的a.installTranslator(&translator)就是将这个translator安装到整个应用程序a中,一旦安装成功,Qt 的事件循环就会自动拦截所有需要显示文本的地方(比如 QLabel 的文本、 QPushButton 的按钮名等),如果这些文本被 tr() 函数标记过,Qt 就会拿着原文去 translator 里查找对应的译文,并显示译文而不是原文。