PySide6使用QThread执行耗时任务仍冻结主GUI的问题求助

核心错误原因 #

你的代码存在一个致命逻辑错误，直接导致耗时任务跑在主线程：

• 信号连接写法错误：self.thread.started.connect(self.worker.run(file)) 这行代码在主线程中同步执行了self.worker.run(file)，并没有把方法绑定到线程启动信号上。connect()方法需要接收可调用对象的引用作为参数，你给方法加了括号、传入参数后，会当场执行该方法，把返回值（None）传给connect，相当于完全没绑定槽函数，耗时计算全部堵在主线程，GUI自然会冻结。

除此之外还有几个潜在隐患：

• 重复绑定信号、重复调用moveToThread：你把thread和worker定义为窗口的持久化属性，每次点击按钮都会重复给同一个对象绑定信号、关联销毁逻辑，第一次任务执行完对象就被deleteLater回收，后续点击会直接崩溃。
• 信号参数不匹配：finished信号定义为需要传递str类型参数，但你调用self.finished.emit()时没有传入参数，运行时会抛出类型警告。
• 按钮初始化时被设置为setEnabled(False)，默认状态下根本无法触发点击逻辑。
• 自定义窗口类没有调用父类__init__方法，会导致UI初始化异常。

正确实现代码 #

推荐每次触发耗时任务时新建Worker和QThread实例，通过functools.partial安全传递任务参数，任务结束后自动销毁线程和工作对象，避免内存泄漏和重复绑定问题：

from PySide6.QtCore import QObject, Signal, QThread
from PySide6.QtWidgets import QMainWindow, QPushButton
import functools


class Worker(QObject):
    finished = Signal(str)
    progress = Signal(int)

    def run(self, file):
        """耗时计算任务"""
        b = SeparateClass()
        compute_result = b.doComputation()
        # 任务完成后发射信号，传入结果
        self.finished.emit(compute_result)


class DataPlotting(QMainWindow):
    def __init__(self):
        super().__init__()
        # 初始化UI
        self.report_builder = QPushButton('Call class that threads', self)
        # 如果需要默认可点击，把下面这行注释或改为True
        # self.report_builder.setEnabled(False)
        self.report_builder.clicked.connect(self.qthread_test)

    def qthread_test(self):
        file = 'some_file.txt'
        # 每次任务新建线程和工作对象，避免重复绑定问题
        self.thread = QThread()
        self.worker = Worker()

        # 把工作对象移动到子线程
        self.worker.moveToThread(self.thread)

        # 正确绑定信号：用partial传递file参数，不要直接调用run()
        self.thread.started.connect(functools.partial(self.worker.run, file))
        # 任务完成后退出线程
        self.worker.finished.connect(self.thread.quit)
        # 任务完成后销毁工作对象和线程
        self.worker.finished.connect(self.worker.deleteLater)
        self.thread.finished.connect(self.thread.deleteLater)

        # 可选：任务完成后接收结果做后续处理
        self.worker.finished.connect(self.on_compute_finished)

        # 启动线程
        self.thread.start()

    def on_compute_finished(self, result):
        """处理计算结果，所有UI操作必须放在主线程的这个槽里执行"""
        print(f"计算完成，结果：{result}")

额外注意事项 #

• 绝对不要在子线程（也就是Worker的run方法、SeparateClass.doComputation()里）直接操作任何GUI控件，所有UI更新必须通过信号传递到主线程的槽函数执行，否则会出现随机崩溃。
• 信号槽连接时永远传可调用对象的引用，不要加括号直接执行方法；如果需要给槽函数传参，优先用functools.partial或者自定义带参数的信号。
• 如果需要实时更新进度，在Worker的计算逻辑里调用self.progress.emit(进度值)，主线程绑定对应槽函数更新进度条即可，不会阻塞UI。

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