Qt 编程 —— 如何实现多语言翻译功能（含源码）

文档声明：
以下资料均属于本人在学习过程中产出的学习笔记，如果错误或者遗漏之处，请多多指正。并且该文档在后期会随着学习的深入不断补充完善。感谢各位的参考查看。

---

笔记资料仅供学习交流使用，转载请标明出处，谢谢配合。
如果存在相关知识点的遗漏，可以在评论区留言，看到后将在第一时间更新。
作者：Aliven888

开发环境：

操作系统：win7 x64 旗舰版
编译器：Visual Studio 2015
Qt开源库：qt-opensource-windows-x86-5.9.6.exe
qt-vs插件：qt-vs-tools-msvc2015-2.1.0.vsix
编译环境：Release x86

如何配置开发环境，可以参考这边文章《VS2015 配置 Qt 开发编译环境》。

创建一个Qt 工程

  首先，我们创建一个Qt的项目工程。这里我选择的是Qt GUI Application，对话框继承 QMainWindows 类型（因为个人觉得菜单栏切换语言语言比较方便）。

添加多语言翻译文件

  创建两个多语言文件 Aliven_zh.ts（中文） 和 Aliven_en.ts（英文）。

编辑翻译文件

  编辑多语言文件，并且发布，生成 Aliven_xx.qm 文件。

实现源码

QtGuiApplication.h

#pragma once

#include <QtWidgets/QMainWindow>
#include "ui_QtGuiApplication.h"
#include <QTranslator>
#include <QCoreApplication>
#include <QMenu>
#include <QAction>
#include <QDir>
#include <QString>
#include <QMap>

class QtGuiApplication : public QMainWindow
{
    
    
	Q_OBJECT

public:
	QtGuiApplication(QWidget *parent = Q_NULLPTR);
	~QtGuiApplication();
	void init();
	void Uninit();
	
private:
	bool loadSysConfigFile();  //加载系统配置文件
	bool saveSysConfigFile();  //保存系统配置文件
	
private:
	//多语言翻译
	QTranslator *m_Translation;  //加载翻译文件对象
	QString m_strLanguageType;   //翻译文件的类型，zh：中文   en：英文

	//菜单
	QMenu *m_LanguageMenu;
	QAction *m_LanguageEnAction;  //英文
	QAction *m_LanguageZhAction;  //中文

private:
	Ui::QtGuiApplicationClass ui;
};

QtGuiApplication.cpp

#include "QtGuiApplication.h"

//多语言文本字符串对象
static const char *c_strQtGuiApplication = "QtGuiApplication";
static const char *c_strTitle = QT_TRANSLATE_NOOP("QtGuiApplication", "Aliven.QtGuiApplication.title"); 
static const char *c_strCaption = QT_TRANSLATE_NOOP("QtGuiApplication", "Aliven.QtGuiApplication.caption");
static const char *c_strLanguage = QT_TRANSLATE_NOOP("QtGuiApplication", "Aliven.QtGuiApplication.language");
static const char *c_strChinese = QT_TRANSLATE_NOOP("QtGuiApplication", "Aliven.QtGuiApplication.chinese");
static const char *c_strEnglish = QT_TRANSLATE_NOOP("QtGuiApplication", "Aliven.QtGuiApplication.english");


QtGuiApplication::QtGuiApplication(QWidget *parent)
	: QMainWindow(parent)
{
    
    
	ui.setupUi(this);
	m_strLanguageType = "zh";   //默认值
}
QtGuiApplication::~QtGuiApplication()
{
    
    
	Uninit();
}

void QtGuiApplication::init()
{
    
    
	//加载配置文件
	if(!loadSysConfigFile())
	{
    
    
		qDebug() << "read config file err.";
	}

	//加载多语言文件
	m_Translation = new QTranslator(this);
	QString strPath = QDir::currentPath() + "/TranslationFile/Aliven_" + m_strLanguageType + ".qm";
	m_Translation->load(strPath);
	qApp->installTranslator(m_Translation);
	
	//初始化菜单 - 绑定信号与槽
	m_LanguageMenu = new QMenu(qApp->translate(c_strQtGuiApplication, c_strLanguage), this);
	m_LanguageEnAction = new QAction(qApp->translate(c_strQtGuiApplication, c_strEnglish), this);
	m_LanguageZhAction = new QAction(qApp->translate(c_strQtGuiApplication, c_strChinese), this);
	m_LanguageMenu->addAction(m_LanguageEnAction);
	m_LanguageMenu->addAction(m_LanguageZhAction);
	ui.menuBar->addMenu(m_LanguageMenu);

	//设置属性为可选中
	m_LanguageEnAction->setCheckable(true);
	m_LanguageZhAction->setCheckable(true);
	if ("zh" != m_strLanguageType) //设置当前选中状态
	{
    
    
		m_LanguageEnAction->setChecked(true);
	}
	else
	{
    
    
		m_LanguageZhAction->setChecked(true);
	}

	connect(m_LanguageZhAction, &QAction::triggered, this, [=] {
    
    
		m_strLanguageType = "zh";
		m_LanguageEnAction->setChecked(false);
	});
	connect(m_LanguageEnAction, &QAction::triggered, this, [=] {
    
    
		m_strLanguageType = "en";
		m_LanguageZhAction->setChecked(false);
	});

}

void QtGuiApplication::Uninit()
{
    
    
	//退出前，保存配置参数到文件中
	SaveSysConfigFile();

	//释放资源
	delete m_LanguageZhAction;
	m_LanguageZhAction = nullptr;

	delete m_LanguageEnAction;
	m_LanguageEnAction = nullptr;

	delete m_LanguageMenu;
	m_LanguageMenu = nullptr;

	delete m_Translation;
	m_Translation = nullptr;
}

//加载系统配置文件
bool QtGuiApplication::loadSysConfigFile()  
{
    
    
	QString strPath = QDir::currentPath() + "/systemConfig.Aliven";
	QMap<QString, QString> mapData;
	QString strLine = "";
	QString strKey = "";
	QString strValue = "";
	QStringList strList;

	QFile file(strPath);
	if (!file.open(QIODevice::ReadOnly))
	{
    
    
		return false;
	}
	QTextStream in(&file);
	while (!in.atEnd())
	{
    
    
		strLine = in.readLine();
		strList.clear();
		strList = strLine.split("=");
		mapData.insert(strList.value(0), strList.value(1));
	}

	file.close();

	//获取配置参数
	if (!mapData.isEmpty())
	{
    
    
		m_strLanguageType = mapData.value("languageType");
	}
	return true;
}

//保存系统配置文件
bool QtGuiApplication::saveSysConfigFile()  
{
    
    
	QString strPath = QDir::currentPath() + "/systemConfig.Aliven";
	QMap<QString, QString> mapData;
	mapData.insert("languageType", m_strLanguageType);

	QFile file(strPath);
	if (!file.open(QIODevice::WriteOnly | QIODevice::Truncate))
	{
    
    
		return false;
	}

	QTextStream out(&file);
	QMapIterator<QString, QString> it(mapData);
	while (it.hasNext())
	{
    
    
		it.next();
		out << it.key() << "=" << it.value() << "\n";
	}
	file.close();
	return true;
}

多语言配置文件

systemConfig.Aliven

languageType=zh

效果图

  初次打开，默认的是中文

  选择英文，关闭后软件后，再次打开，系统语言就成功切换成英文了。