PySide6/Qt Creator向按钮标签添加Emoji时静默崩溃求助

问题背景 #

使用Qt Creator设计GUI时，给按钮标签添加Emoji后程序静默崩溃。排查发现问题出在pyside6-uic从UI文件生成的Python代码中：自动生成的retranslateUI()函数用Unicode十六进制转义序列表示Emoji，而QCoreApplication.translate()无法正确处理这类转义序列，导致崩溃。手动将转义序列替换为实际Emoji字符可正常运行，但自动生成的代码会因后续UI更新被覆盖，无法持久修改。

环境：PySide6 v6.9.1、Python 3.13、Windows 11

原因分析 #

直接给QPushButton设置带Emoji的字符串（无论是实际字符还是转义序列）都能正常显示，但通过QCoreApplication.translate()处理转义序列时会崩溃。这是因为部分Emoji由多个Unicode代码点组成（如🤣对应\ud83e\udd23\ufe0f），translate()函数无法正确解析这种转义形式的代理对，进而引发崩溃。

解决方案 #

1. 强制pyside6-uic生成Emoji字符而非转义序列 #

在生成Python代码时，指定UI文件的编码为UTF-8，让工具直接输出Emoji字符：

pyside6-uic --from-encoding=utf-8 your_ui_file.ui -o your_ui_file.py

也可在Qt Creator中设置UI文件编码为UTF-8（编辑器设置→文本编辑器→行为→文件编码），确保保存时Emoji以原生字符存储，生成代码时就不会被转义。

2. 重写retranslateUI方法覆盖自动生成的文本 #

不修改自动生成的代码，在自定义窗口类中重写retranslateUI，先调用父类方法，再手动设置按钮文本为带实际Emoji的字符串：

from PySide6.QtWidgets import QMainWindow
from ui_mainwindow import Ui_MainWindow  # 自动生成的UI类

class MainWindow(QMainWindow, Ui_MainWindow):
    def __init__(self):
        super().__init__()
        self.setupUi(self)

    def retranslateUi(self, MainWindow):
        # 执行自动生成的翻译逻辑
        super().retranslateUi(MainWindow)
        # 手动替换按钮文本，使用实际Emoji字符
        self.pushButton.setText(QCoreApplication.translate("MainWindow", "click me 🤣️", None))

这样每次UI更新后，自动生成的代码会被执行，但我们的手动设置会覆盖有问题的转义序列文本。

3. 补丁QCoreApplication.translate函数解码转义序列 #

在程序入口处对translate函数打补丁，自动解码字符串中的Unicode转义序列后再处理：

import sys
from PySide6.QtWidgets import QApplication
from PySide6.QtCore import QCoreApplication

# 保存原translate函数
original_translate = QCoreApplication.translate

def patched_translate(context, text, disambiguation=None):
    try:
        # 解码Unicode转义序列为实际字符
        decoded_text = text.encode().decode("unicode-escape")
        return original_translate(context, decoded_text, disambiguation)
    except Exception:
        # 解码失败时 fallback 到原文本
        return original_translate(context, text, disambiguation)

# 替换原函数
QCoreApplication.translate = patched_translate

# 后续导入UI类和启动程序
from ui_mainwindow import Ui_MainWindow
from mainwindow import MainWindow

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

此方法无需修改生成的代码，所有translate调用都会自动处理转义序列，避免崩溃。

内容的提问来源于stack exchange，提问作者Joel Santos Rico