如何从非GUI线程调用GUI应用线程内的方法？

核心方案（无需自定义信号） #

Qt 原生就提供了两种无需自定义信号的跨线程调用UI的方式，比自定义信号更轻便，适合临时调用场景：

• 方案1：使用QMetaObject.invokeMethod （兼容性最好，支持所有Qt5/Qt6版本，PyQt/PySide通用）
  该方法可以直接向指定对象所属的线程的事件循环投递方法调用请求，自动确保方法在对象所属的线程（此处为GUI线程）执行。示例代码如下：

from PyQt5.QtCore import QMetaObject, Qt, Q_ARG

# 以下代码在非GUI线程中执行，序列化任务完成后调用
QMetaObject.invokeMethod(
    your_ui_object,  # 目标UI对象，例如主窗口实例，本身隶属于GUI线程
    "your_update_ui_method",  # 要调用的UI更新方法名，字符串格式
    Qt.QueuedConnection,  # 固定使用队列连接，确保投递到目标线程执行
    # 若方法需要传参，按顺序添加Q_ARG即可，格式为Q_ARG(参数类型, 参数值)
    Q_ARG(bool, True),
    Q_ARG(str, "文档序列化完成")
)

注意：如果是PySide，无需使用Q_ARG，直接传递参数即可。

• 方案2：指定GUI上下文的QTimer.singleShot （写法更简洁，适合无参数的UI更新调用）
  你之前踩到的坑是因为在非GUI线程调用QTimer.singleShot时没有指定所属上下文，所以定时器绑定到了当前非GUI线程的事件循环。只要显式指定属于GUI线程的上下文对象（比如全局应用实例），就能保证回调在GUI线程执行：

from PyQt5.QtCore import QTimer, QCoreApplication

# 以下代码在非GUI线程中执行
QTimer.singleShot(
    0,  # 0延时，事件循环空闲时立即执行
    QCoreApplication.instance(),  # 上下文对象为应用实例，隶属于GUI线程
    your_update_ui_function  # 要执行的UI更新回调
)

补充说明 #

如果你的项目中存在大量同类跨线程UI调用场景，自定义信号的方式可维护性更高；如果是单次临时调用，上述两种方案足够简单，不需要额外定义信号和绑定槽函数。
你现有的线程校验装饰器可以保留作为兜底校验，避免误调用导致的UI崩溃问题。

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