使用QThread后PyQt主线程仍阻塞的问题排查与解决请求

核心问题 #

你的QThread完全没起到后台执行任务的作用：

• WorkThread的run方法只是发射了一个信号，实际计算逻辑calculate是通过信号槽在主线程中执行的
• 超大循环直接阻塞主线程，导致加载对话框的动画无法刷新、UI失去响应

修正思路 #

1. 把耗时的计算逻辑直接放到WorkThread的run方法中，让后台线程真正承担计算任务
2. 计算完成后通过信号通知主线程，由主线程处理UI操作（比如关闭加载对话框）
3. 确保加载对话框的动画资源不被提前回收

修正后的代码 #

from PyQt5.QtCore import QThread, Signal, Qt
from PyQt5.QtWidgets import QDialog, QMainWindow
from PyQt5.QtGui import QMovie
# 假设你的Ui_Dialog和Ui_MainWindow已经正确导入

# 后台计算线程
class WorkThread(QThread):
    calculationFinished = Signal(int)  # 用于传递计算结果的信号

    def __init__(self):
        super().__init__()

    def run(self):
        # 耗时计算放在run方法，在后台线程执行
        sum_result = 0
        for i in range(100000000):
            sum_result += i
        self.calculationFinished.emit(sum_result)  # 计算完成后通知主线程

# 加载对话框
class LoadingDialog(QDialog):
    def __init__(self):
        super().__init__()
        self.ui = Ui_Dialog()
        self.ui.setupUi(self)
        # 将movie设为实例变量，避免被GC回收导致动画停止
        self.movie = QMovie(':\icons\images\icons\loading.gif')
        self.ui.label_2.setMovie(self.movie)
        self.ui.label_2.setScaledContents(False)
        self.movie.start()
        self.setAttribute(Qt.WA_TranslucentBackground)
        self.setModal(False)  # 设置为非模态，不阻塞主线程
        self.show()

# 主窗口
class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)
        self.ui.pushButton.clicked.connect(self.buttonClick)
        self.show()

    def buttonClick(self):
        if self.sender().objectName() == 'pushButton':
            self.dialog = LoadingDialog()
            self.thread1 = WorkThread()
            # 连接计算完成信号，处理UI关闭和结果展示
            self.thread1.calculationFinished.connect(self.onCalculationDone)
            self.thread1.start()

    def onCalculationDone(self, result):
        self.dialog.close()
        print(f"求和结果：{result}")

关键注意事项 #

• 耗时任务必须放在run方法：QThread的run方法是线程的入口，只有这里的代码会在后台线程执行
• 信号仅用于线程间通信：后台线程完成任务后，通过信号通知主线程处理UI，绝不能用信号把耗时任务抛回主线程
• UI操作必须在主线程执行：Qt规定所有UI相关操作都要在主线程完成，信号槽机制会自动处理跨线程的调用调度

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