Qt(PySide2)中如何从其他线程简便调用主线程的函数与方法？

针对你提到的每次跨线程调用都要单独定义信号槽的冗余问题，可以通过Qt元对象系统的内置能力封装通用调用工具，一次封装后所有场景都可复用，无需重复定义信号槽代理。

核心实现逻辑 #

Qt的QMetaObject::invokeMethod原生支持跨线程调用对象的可调用方法，基于该接口封装可变参数的模板函数，即可适配任意方法、任意参数的跨线程调用需求。

具体实现 #

C++ 版本（适用于Qt 5.10及以上） #

#include <QMetaObject>
#include <QThread>
#include <functional>

template<typename Func, typename... Args>
void runOnMainThread(QObject* mainThreadObj, Func&& method, Args&&... params) {
    // 校验目标对象是否存活，可根据需求加断言
    Q_ASSERT(mainThreadObj != nullptr);
    // 当前已经在主线程，直接调用减少开销
    if (QThread::currentThread() == mainThreadObj->thread()) {
        std::invoke(std::forward<Func>(method), std::forward<Args>(params)...);
        return;
    }
    // 异步抛到主线程事件队列执行
    QMetaObject::invokeMethod(mainThreadObj, [=]() mutable {
        std::invoke(std::forward<Func>(method), std::forward<Args>(params)...);
    }, Qt::QueuedConnection);
}

PyQt/PySide 版本 #

from PySide6.QtCore import QObject, QMetaObject, QThread, Qt
import functools

def run_on_main_thread(main_obj: QObject, func, *args, **kwargs):
    if not main_obj:
        return
    # 已在主线程直接调用
    if QThread.currentThread() == main_obj.thread():
        func(*args, **kwargs)
        return
    # 异步调度到主线程执行
    QMetaObject.invokeMethod(
        main_obj,
        functools.partial(func, *args, **kwargs),
        Qt.QueuedConnection
    )

调用方式与注意事项 #

• 被调用的主线程对象方法需要提前用Q_INVOKABLE宏修饰，或者声明为槽函数，确保元对象系统可识别。
• 如果需要等待方法执行完成获取返回值，可将连接类型替换为Qt::BlockingQueuedConnection，禁止在主线程中使用该模式，会触发死锁。
• 自定义类型作为参数传递时，需要提前用qRegisterMetaType注册类型，否则Qt元系统无法完成参数序列化。
• 参数建议优先传值而非引用/指针，避免异步调用时参数生命周期结束导致的悬空引用问题。

该方案一次封装即可全项目复用，完全不需要为每个跨线程调用场景单独定义信号槽，大幅降低重复工作量。

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