PySide6 QThread在PyCharm调试模式下的异常行为问题

我尝试使用QThread在后台执行长时间计算，同时保持UI正常运行。但发现程序在PyCharm调试模式下线程无法正常工作，以下是最小复现示例：

from PySide6.QtCore import QObject, QThread


class Worker(QObject):

    def work(self):
        while True:
            print("working")


if __name__ == "__main__":

    thread = QThread()
    worker = Worker()

    worker.moveToThread(thread)
    thread.started.connect(worker.work)

    thread.start()

    while True:
        print("do other stuff")

非调试模式下，程序会反复打印"working"和"do other stuff"；但在调试模式下仅打印"do other stuff"，work方法完全未被调用。使用环境为PySide 6.5.0和Python 3.10。

核心原因 #

这是因为PyCharm的调试器默认会阻塞主线程的Qt事件循环，而QThread的started信号依赖Qt事件循环分发才能触发。

你的代码里主线程被一个无限while True循环占据，没有给Qt事件循环运行的机会。在非调试模式下，Python的GIL（全局解释器锁）调度会让后台线程有机会执行；但调试模式下，PyCharm的调试钩子会强制主线程持续占用GIL，同时Qt的事件循环完全无法运转，导致thread.started信号根本无法被传递给worker.work方法，后台线程自然不会执行。

验证与解决思路 #

如果把主线程的无限循环替换成Qt的事件循环（比如QApplication.exec()），调试模式下线程就能正常工作：

from PySide6.QtCore import QObject, QThread
from PySide6.QtWidgets import QApplication
import sys

class Worker(QObject):
    def work(self):
        while True:
            print("working")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    
    thread = QThread()
    worker = Worker()
    worker.moveToThread(thread)
    thread.started.connect(worker.work)
    thread.start()
    
    print("do other stuff")
    sys.exit(app.exec())

这样修改后，Qt事件循环会负责处理信号分发，调试器不会再阻塞线程的启动信号传递。

另外，即使不用UI，也可以通过在主线程的循环中调用QThread.msleep()或者QCoreApplication.processEvents()来给事件循环留运行空间，比如：

from PySide6.QtCore import QObject, QThread, QCoreApplication

class Worker(QObject):
    def work(self):
        while True:
            print("working")

if __name__ == "__main__":
    thread = QThread()
    worker = Worker()
    worker.moveToThread(thread)
    thread.started.connect(worker.work)
    thread.start()

    while True:
        print("do other stuff")
        QCoreApplication.processEvents()  # 处理待办事件
        QThread.msleep(100)  # 让出CPU时间

内容的提问来源于stack exchange，提问作者Hendrik Hübner