Qt怎么编写多语言国际化翻译程序-C++-PHP中文网

Qt多语言核心是tr()标记→lupdate提取.ts→lrelease编译.qm→QTranslator查表的协作链路；关键在流程完整、路径正确、上下文不冲突，而非编写翻译逻辑。

qt怎么编写多语言国际化翻译程序

Qt 多语言不是“写个翻译程序”，而是搭建一套 tr() 标记 + .ts 提取 + .qm 加载 + QTranslator 查表的协作链路。真正要写的代码极少，关键在流程不漏环节、路径不写错、上下文不冲突。

只有继承自 QObject 的类里直接调用 tr("xxx") 才有效；非 QObject 类（比如纯数据结构、工具函数）必须显式写 QObject::tr("xxx")，否则 lupdate 扫不出来。

✅ 正确：ui->label->setText(tr("Save"));（MainWindow 是 QObject 派生类）
❌ 无效：QString s = "Save"; ui->label->setText(s);（没走 tr()，完全不会进翻译流程）
⚠️ 易错：UI 文件（.ui）里的文字默认不进 tr() —— 必须在 Qt Designer 中勾选「Translatable」属性，或手动在 ui_*.h 生成代码里补上 tr()（推荐前者）
⚠️ 消歧义必须显式传参：tr("File", "menu item") 和 tr("File", "verb") 在 .ts 里是两条独立条目，漏写 disambiguation 会导致翻译错位

lupdate 不是编译器，它只做静态文本扫描。它看不到运行时拼接的字符串，也认不出宏展开后的字面量。

❌ 不支持变量：QString key = "Open"; tr(key.toUtf8()); → lupdate 完全忽略
❌ 不支持宏定义：#define MSG "Exit" ... tr(MSG) → 多数 Qt 版本（尤其 Qt 6.5+）默认不展开宏，需在 .pro 或 CMakeLists.txt 中加 CONFIG += linguist_resource 或等效配置
✅ 必须确保 .pro 里声明了源文件：SOURCES += main.cpp mainwindow.cpp，否则 lupdate 不知道扫哪些文件
✅ 建议加注释提示翻译者：tr("OK") // Button label, confirm action，lupdate 会把注释提取进 .ts 的节点

load() 成功只代表文件读取和解析无误，不代表翻译已生效。真正起作用的是安装顺序和对象生命周期。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

❌ 局部创建：{ QTranslator t; t.load("zh_CN.qm"); qApp->installTranslator(&t); } → t 出作用域即析构，翻译器失效
❌ 安装太晚：QApplication a(argc, argv); MainWindow w; w.show(); QTranslator t; t.load("zh_CN.qm"); a.installTranslator(&t); → 窗口已构建完成，内部控件文本早已调用过 tr() 并缓存为原文，不会自动重刷
✅ 正确时机：在 main() 中 QApplication 构造后、任何窗口创建前安装；切换语言时，先 removeTranslator()，再 load() + installTranslator()，最后调用 w->retranslateUi(w) 或触发 changeEvent(QEvent::LanguageChange)
✅ 路径别硬编码：t.load("zh_CN.qm") 默认找当前工作目录；生产环境建议用 t.load("zh_CN.qm", ":/i18n")（资源路径）或 t.load("zh_CN.qm", QApplication::applicationDirPath() + "/translations")

.qm 文件本身是 UTF-8 编码，但最终渲染依赖系统字体是否支持对应字符集。Qt 不负责字体 fallback，只负责把翻译后的字符串交给控件绘制。

❌ Windows 上默认中文字体（如 SimSun）在英文界面下可能缺失，导致中文显示为方块；需显式设置字体：qApp->setFont(QFont("Microsoft YaHei", 9));
❌ Linux 下未安装中文字体（如 fonts-wqy-zenhei），即使 .qm 正确加载，QLabel 仍画不出汉字
✅ 验证是否真乱码：在 .ts 文件里直接查看内容是否为合法 UTF-8 中文（用 VS Code 或 Notepad++ 以 UTF-8 无 BOM 打开）；若 XML 里已是乱码，说明编辑时保存编码错了
✅ Qt 6 起默认禁用 QTextCodec::setCodecForLocale()，不要在代码里手动设 GBK/GB2312 —— 这只会让 tr() 解析源码字符串时出错