PyQt5 QThread失效：GUI仍卡顿问题排查求助

你的代码里GUI线程被阻塞的核心原因，出在_threaded_call方法中这一行：

thread.started.connect(lambda: fn(*args)) # fn needs to be slot

虽然你已经把WorkerOne实例moveToThread到了新创建的子线程，但直接在lambda里调用worker的方法，并不会让这个方法在子线程中执行。lambda函数本身是在主线程的上下文里被调用的，所以print_name方法实际上是在主线程中运行的——这自然会导致GUI阻塞，因为time.sleep(1)和循环都在主线程里执行了。

PyQt中，跨线程调用对象方法的正确方式是通过信号-槽机制：当信号在一个线程发出，槽函数如果属于另一个线程的QObject，Qt会自动把槽函数的执行切换到它所属的线程中。直接调用方法则不会触发这个机制。

我们需要修改_threaded_call的实现，用信号来触发worker的方法，而不是直接调用。这里有两种简单的修改方式：

方式1：给Worker类添加触发信号 #

首先，在Worker基类中添加一个自定义信号，用来触发任务执行：

class Worker(QObject):
    def __init__(self):
        super().__init__()
        self.thread = None
        # 添加触发任务的信号，根据需要设置参数类型
        self.trigger_task = pyqtSignal(str)

class WorkerOne(Worker):
    finished = pyqtSignal()
    def __init__(self):
        super().__init__()
        # 把信号连接到自己的槽函数
        self.trigger_task.connect(self.print_name)

    @pyqtSlot(str)
    def print_name(self, name):
        for _ in range(100):
            print("Hello there, {0}!".format(name))
            time.sleep(1)
        self.finished.emit()
        self.thread.quit()

然后修改_threaded_call中的连接逻辑，把thread.started连接到worker的trigger_task信号：

def _threaded_call(self, worker, fn, *args, signals=None, slots=None):
    thread = QThread()
    thread.setObjectName('thread_' + worker.__class__.__name__)

    self.threads[worker] = thread
    worker.thread = thread

    # 移除多余的moveToThread操作，直接移到新线程即可
    worker.moveToThread(thread)

    if signals:
        for signal, slot in signals.items():
            try:
                signal.disconnect()
            except TypeError:
                pass
            signal.connect(slot)
    if slots:
        for slot, signal in slots.items():
            try:
                signal.disconnect()
            except TypeError:
                pass
            signal.connect(slot)

    # 用信号触发任务，而不是直接调用方法
    thread.started.connect(lambda: worker.trigger_task.emit(*args))
    thread.start()

方式2：使用QMetaObject.invokeMethod跨线程调用（更灵活） #

如果不想给每个Worker都加触发信号，可以用QMetaObject.invokeMethod来实现跨线程调用槽函数，修改_threaded_call中的连接部分：

def _threaded_call(self, worker, fn, *args, signals=None, slots=None):
    # ... 其他代码保持不变 ...

    # 定义启动任务的函数，用invokeMethod确保在worker线程执行
    def start_task():
        from PyQt5.QtCore import QMetaObject, Qt
        # 构造参数列表，适配invokeMethod的格式
        arg_list = []
        for arg in args:
            arg_list.append(pyqtArg(arg))
        QMetaObject.invokeMethod(worker, fn.__name__, Qt.QueuedConnection, *arg_list)
    
    thread.started.connect(start_task)
    thread.start()

你的代码里还有一行多余的操作：

worker.moveToThread(QThread.currentThread())

这行完全没必要，直接调用worker.moveToThread(thread)就可以把worker移到新线程，不需要先移回主线程。

修改后再运行，点击按钮启动线程，GUI就不会再阻塞了——print_name会在子线程中循环打印，窗口可以正常拖动、操作。

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