PyQt6中如何实时切换gettext语言并更新界面文本

问题本质：Gettext的install()仅影响后续调用_()的代码，已初始化的控件文本是创建时就固定的字符串，不会自动重新调用_()更新。要实现实时切换，核心是让所有已创建的翻译控件重新获取最新翻译文本。

低成本实现步骤 #

1. 标记并绑定翻译键到控件 #

创建控件时，给所有需要翻译的元素（按钮、菜单、Action等）绑定对应的翻译键（就是你传给_()的原始字符串），同时标记可翻译属性，方便后续批量查找：

# 示例：创建带翻译绑定的按钮
self.open_btn = QPushButton(_("Open"))
self.open_btn.setProperty("trans_key", "Open")  # 绑定原始翻译键
self.open_btn.setObjectName("translatable")     # 标记为可翻译控件

# 示例：创建带翻译绑定的菜单
self.file_menu = self.menuBar().addMenu(_("File"))
self.file_menu.setProperty("trans_key", "File")
self.file_menu.setObjectName("translatable")

# 示例：菜单Action同理
self.open_action = QAction(_("Open File"), self)
self.open_action.setProperty("trans_key", "Open File")

2. 实现全局文本刷新函数 #

遍历所有标记的控件，根据类型重新调用_()获取最新翻译并更新文本：

def refresh_all_translations(self):
    # 刷新所有带标记的Widget（按钮、标签、菜单等）
    for widget in self.findChildren(QWidget, "translatable"):
        trans_key = widget.property("trans_key")
        if not trans_key:
            continue
        if isinstance(widget, QPushButton):
            widget.setText(_(trans_key))
        elif isinstance(widget, QMenu):
            widget.setTitle(_(trans_key))
        elif isinstance(widget, QLabel):
            widget.setText(_(trans_key))
        # 按需添加其他控件类型

    # 刷新所有菜单Action
    for action in self.findChildren(QAction):
        trans_key = action.property("trans_key")
        if trans_key:
            action.setText(_(trans_key))

3. 切换语言时触发刷新 #

调用Gettext的install()后，立刻执行刷新函数即可：

def switch_language(self, lang):
    # 加载目标语言翻译
    trans = gettext.translation("your_app_name", localedir="locales", languages=[lang])
    trans.install()
    # 同步更新所有控件文本
    self.refresh_all_translations()

简化小技巧 #

如果不想给每个控件加objectName，可以直接遍历所有控件并检查是否有trans_key属性，不过效率略低但实现更简单：

def refresh_all_translations(self):
    # 遍历所有Widget
    for widget in self.findChildren(QWidget):
        trans_key = widget.property("trans_key")
        if trans_key:
            # 根据控件类型更新文本
            if isinstance(widget, (QPushButton, QLabel)):
                widget.setText(_(trans_key))
            elif isinstance(widget, QMenu):
                widget.setTitle(_(trans_key))
    # 处理Action
    for action in self.findChildren(QAction):
        trans_key = action.property("trans_key")
        if trans_key:
            action.setText(_(trans_key))

备选：切换到PyQt内置翻译机制 #

如果上述方案仍觉繁琐，可以改用PyQt的QTranslator：

1. 将所有_()替换为self.tr()（或QApplication.translate()）
2. 生成并加载.qm翻译文件：

self.translator = QTranslator()
self.translator.load(f"{lang}.qm", "./translations")
QApplication.instance().installTranslator(self.translator)

3. 触发全局刷新（PyQt会自动处理大部分控件的文本更新）：

# 强制触发翻译更新
QApplication.instance().translate("", "")
# 手动刷新窗口和菜单确保生效
self.update()
self.menuBar().update()

这种方式无需维护控件列表，但需要重新整理翻译流程，生成Qt格式的翻译文件。

内容的提问来源于stack exchange，提问作者Lampe2020