PySide6中Worker构造函数嵌套定义run为何在主线程执行？

问题场景 #

在使用PySide6实现Qt多线程时，尝试利用Python闭包保留状态的特性，在_ConcurrentWorker类的构造函数中嵌套定义run方法，代码如下：

from PySide6.QtCore import QObject, Signal
from typing import Callable

class _ConcurrentWorker(QObject):
    success = Signal()
    failed = Signal(str)
    finished = Signal()
    quit = Signal()

    def __init__(self, do_work: Callable[[], None], repeat):
        super().__init__()
        self._loop = True
        self.quit.connect(self.on_quit)

        def run():
            try:
                while self._loop:
                    do_work()
                    self.success.emit()
                    if not repeat:
                        break
            except Exception as e:
                self.failed.emit(repr(e))
            finally:
                self.finished.emit()
        self.run = run

    def on_quit(self):
        self._loop = False

该Worker类被ConcurrentTask类封装（负责创建QThread并将Worker移至该线程），调用ConcurrentTask实例的start()方法后，发现_ConcurrentWorker的run方法在主线程中执行，导致GUI阻塞；而将run定义为类成员方法时，代码可正常在目标QThread中运行：

from PySide6.QtCore import QObject, Signal
from typing import Callable

class _ConcurrentWorker(QObject):
    success = Signal()
    failed = Signal(str)
    finished = Signal()
    quit = Signal()

    def __init__(self, do_work: Callable[[], None], repeat):
        super().__init__()
        self._do_work = do_work
        self._repeat = repeat
        self._loop = True
        self.quit.connect(self.on_quit)

    def run(self):
        try:
            while self._loop:
                self._do_work()
                self.success.emit()
                if not self._repeat:
                    break
        except Exception as e:
            self.failed.emit(repr(e))
        finally:
            self.finished.emit()

    def on_quit(self):
        self._loop = False

原因解析 #

1. Qt线程亲和性的作用范围限制 #

Qt的QObject及其子类具有线程亲和性：每个QObject实例默认属于创建它的线程，调用moveToThread()可将其转移到目标线程。但线程亲和性仅对Qt识别的成员方法生效——类中定义的成员方法会跟随QObject实例的线程归属被调度，而闭包定义的函数不在Qt的管理范围内。

2. 闭包的执行上下文绑定 #

嵌套在__init__中的run闭包是在主线程中创建的，尽管被赋值给了self.run，但它的执行上下文始终绑定到定义它的主线程。当触发该函数执行时，Python解释器会直接在主线程中运行它，完全无视Worker实例所在的目标QThread。

3. 类成员方法的调度逻辑 #

当run是类的成员方法时，Qt会将其识别为QObject实例的一部分。由于Worker已被moveToThread()移至目标线程，调用该方法时，Qt的线程调度机制会自动将方法的执行切换到Worker所属的线程，从而实现真正的多线程执行，避免GUI阻塞。

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