Qt多语言动态切换需三步：所有文本必须用tr()包裹；安装新QTranslator后发送QEvent::LanguageChange事件；控件在changeEvent中调用retranslateUi()或手动更新setText()等。

Qt 多语言动态切换不是“换翻译器就完事”，关键在换完之后让所有已存在的控件重新走一遍 tr() 查表流程。硬编码字符串、没重发 QEvent::LanguageChange、QTranslator 生命周期管理错，都会导致界面纹丝不动。

tr() 必须覆盖所有界面文本，否则切换无效

这是最常被忽略的前提：只有被 tr() 包裹的字符串才会响应翻译器变化。直接写 label->setText("Save") 或 button->setWindowTitle("Settings")，切语言后永远不变。

• UI 文件（.ui）中所有 text、toolTip、windowTitle 等属性默认可翻译，但需确保“Translatable”复选框勾选（Qt Designer 右侧属性栏）
• 自定义控件中，所有 setText()、setWindowTitle()、setStatusTip() 等调用必须用 tr("xxx")
• 动态生成的内容（如表格单元格、弹窗标题、状态栏消息）同样要走 tr()，不能靠“初始化时设一次”就不管

installTranslator 后必须手动触发 LanguageChange 事件

qApp->installTranslator() 只影响后续新建控件；已有控件不会自动刷新。必须显式通知 Qt “语言变了”，让它驱动 changeEvent(QEvent::LanguageChange) 流程。

• 先调 qApp->removeTranslator(oldTranslator)，再 qApp->installTranslator(newTranslator)
• 接着发事件：qApp->postEvent(qApp, new QEvent(QEvent::LanguageChange))（推荐）或 qApp->sendEvent(qApp, new QEvent(QEvent::LanguageChange))
• 主窗口和所有已显示对话框会收到该事件，只要它们继承自 QWidget 并未屏蔽该事件，就会触发 changeEvent 回调

QWidget::changeEvent 中必须调用 retranslateUi 或手动更新

系统发来 QEvent::LanguageChange 后，控件自己得知道怎么“重翻译”。Qt Designer 生成的 UI 类自带 retranslateUi() 函数，但你得主动调它。

C++14

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

下载

立即学习“C++免费学习笔记（深入）”；

• 若使用 ui->setupUi(this)，则在 changeEvent 中加判断：

  void MainWindow::changeEvent(QEvent *event) {
      if (event->type() == QEvent::LanguageChange) {
          ui->retranslateUi(this);
      }
      QWidget::changeEvent(event);
  }

• 纯手写控件（无 .ui），需在 changeEvent 中逐个调用 label->setText(tr("..."))、button->setText(tr("...")) 等
• 注意：不要在 changeEvent 里 delete 或 recreate 控件——这会丢状态、闪屏、破坏父子关系

QTranslator 加载失败的三个高频原因

界面没变，90% 是翻译文件根本没加载成功，而不是刷新逻辑错了。

• QTranslator::load() 返回 false？检查路径：用 QApplication::applicationDirPath() + "/translations/zh_CN.qm" 拼接，别用相对路径
• 文件是 .ts 不是 .qm？lrelease 必须运行过，.qm 才能被 load() 识别；.ts 是编辑用的 XML，不能直接 load
• 中文路径或空格路径在 Windows 上易出错：把 translations 目录放在英文路径下（如 ./res/i18n/），避免 加载失败但无报错

真正难的不是写几行切换代码，而是确保每个控件都注册了 changeEvent 响应、每处文本都经过 tr()、每次 load() 都校验返回值——漏掉任意一环，语言就卡死在初始状态。