Qt 多语言切换功能完整实现指南

无界猴

7个月前更新

054250

在 Qt 中实现语言切换功能，可以通过使用 QTranslator 类和 Qt 的国际化工具（如 lupdate 和 linguist）来完成。以下是完整的实现指南，包括从翻译文件的生成到动态切换语言的代码实现。

1. 准备工作

1.1 安装 Qt 开发环境

确保已安装 Qt 开发环境（包括 Qt Creator 和相关工具链）。

1.2 创建项目

打开 Qt Creator，创建一个新的 Qt Widgets Application 项目。

2. 标记需要翻译的字符串

在代码中使用 QObject::tr() 或 tr() 标记需要翻译的字符串。例如：

ui->label->setText(tr("Hello, World!"));
ui->button->setText(tr("Click Me"));

注意：

只有使用 tr() 标记的字符串才会被提取到翻译文件中。
如果字符串是在 UI 文件中直接设置的，Qt 会自动处理，无需手动标记。

3. 生成翻译文件

3.1 修改 `.pro` 文件

在项目的 .pro 文件中添加需要支持的语言。例如：

TRANSLATIONS += translations/app_zh_CN.ts \
                translations/app_en_US.ts

3.2 提取翻译字符串

在 Qt Creator 中，选择 工具 -> 外部 -> Qt 语言家 -> 更新翻译 (lupdate)，这将生成 .ts 翻译文件。

3.3 编辑翻译文件

使用 Qt Linguist 工具打开生成的 .ts 文件，为每个字符串添加翻译：

打开 .ts 文件。
在“源文本”列中找到需要翻译的字符串。
在“翻译”列中输入对应的翻译内容。
保存并关闭文件。

3.4 生成二进制翻译文件

在 Qt Creator 中，选择 工具 -> 外部 -> Qt 语言家 -> 发布翻译 (lrelease)，这将生成 .qm 文件（二进制翻译文件）。

4. 加载翻译文件

在代码中动态加载翻译文件，并切换语言。

4.1 创建 `QTranslator` 对象

在主窗口类中添加一个 QTranslator 对象，用于加载翻译文件。

4.2 加载翻译文件

编写一个函数，用于加载指定语言的翻译文件。例如：

#include <QTranslator>
#include <QApplication>
#include <QLocale>
#include <QDebug>

class MainWindow : public QMainWindow {
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

    void switchLanguage(const QString &language);

private:
    QTranslator translator;
};

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent) {
    // 默认加载英文
    switchLanguage("en_US");
}

MainWindow::~MainWindow() {}

void MainWindow::switchLanguage(const QString &language) {
    // 卸载当前翻译
    qApp->removeTranslator(&translator);

    // 加载新的翻译文件
    QString filePath = QString(":/translations/app_%1.qm").arg(language);
    if (translator.load(filePath)) {
        qApp->installTranslator(&translator);
        ui->retranslateUi(this); // 重新翻译界面
    } else {
        qDebug() << "Failed to load translation file:" << filePath;
    }
}

4.3 调用切换函数

在按钮点击事件中调用 switchLanguage() 函数。例如：

void MainWindow::on_chineseButton_clicked() {
    switchLanguage("zh_CN");
}

void MainWindow::on_englishButton_clicked() {
    switchLanguage("en_US");
}

5. 资源文件配置

将生成的 .qm 文件添加到 Qt 资源文件（.qrc）中，以便在程序中直接访问。例如：

<RCC>
    <qresource prefix="/translations">
        <file>translations/app_zh_CN.qm</file>
        <file>translations/app_en_US.qm</file>
    </qresource>
</RCC>

6. 运行与测试

编译并运行程序。
点击语言切换按钮，验证界面语言是否正确切换。

7. 注意事项

动态创建的控件：
- 如果控件是动态创建的，确保在设置文本时使用 tr() 标记字符串。
- 或者在语言切换时手动更新控件文本。
UI 文件中的控件：
- 如果控件是在 UI 文件中创建的，语言切换时会自动更新文本，无需额外处理。
语言环境：
- 可以使用 QLocale 类检测系统语言环境，并自动加载对应的翻译文件。
多线程：
- 如果应用程序涉及多线程，确保翻译文件的加载和切换在主线程中完成。

8. 示例代码结构

MyApp/
├── main.cpp
├── mainwindow.h
├── mainwindow.cpp
├── mainwindow.ui
├── translations/
│   ├── app_zh_CN.ts
│   ├── app_en_US.ts
│   ├── app_zh_CN.qm
│   ├── app_en_US.qm
└── resources.qrc