如何实现QThread与主类Widgets通信？解决PyQt5程序冻结问题

核心问题分析 #

你的GUI冻结是因为在主线程中执行了阻塞性的循环和time.sleep，这会卡住主线程的事件循环，导致界面无法响应。另外，子线程（Worker）不能直接访问主线程的GUI控件，PyQt规定只有主线程能操作UI元素，跨线程直接访问会引发崩溃或异常行为。

修正后的完整代码 #

from PyQt5 import QtCore, QtGui, QtWidgets
from PyQt5.uic import loadUi

## 主窗口类
class HWindow(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        loadUi("Hw.ui", self)
        self.runningMain = False

        # 初始化线程与Worker
        self.thread = QtCore.QThread()
        self.workerMain = WorkerMain()
        self.workerMain.moveToThread(self.thread)

        # 关联信号槽：实现主线程与子线程的安全通信
        self.workerMain.request_state.connect(self.send_current_ui_state)
        self.chkb_main.toggled.connect(self.activateMain)
        self.thread.finished.connect(self.thread.deleteLater)

        # 启动线程（此时Worker的run方法未执行，需手动触发）
        self.thread.start()

    def activateMain(self, checked):
        if checked:
            self.lbl_disena_main.setText("Activated")
            self.lbl_disena_main.setStyleSheet('color: green;')
            self.workerMain.set_running(True)
            # 延迟触发Worker的循环逻辑，避免线程启动冲突
            QtCore.QTimer.singleShot(0, self.workerMain.run)
        else:
            self.lbl_disena_main.setText("Disabled")
            self.lbl_disena_main.setStyleSheet('color: red;')
            self.workerMain.set_running(False)

    def send_current_ui_state(self):
        # 主线程获取UI状态，通过信号传递给子线程
        chkb_state = self.chkb_main.isChecked()
        gpb_state = self.gpb_main.isChecked()
        self.workerMain.update_ui_state.emit(chkb_state, gpb_state)

## 子线程Worker类
class WorkerMain(QtCore.QObject):
    # 定义信号：用于请求主线程返回UI状态、接收主线程传递的UI状态
    request_state = QtCore.pyqtSignal()
    update_ui_state = QtCore.pyqtSignal(bool, bool)

    def __init__(self):
        super().__init__()
        self.running = False
        self._chkb_state = False
        self._gpb_state = False

        # 关联接收UI状态的槽函数
        self.update_ui_state.connect(self._update_state)

    @QtCore.pyqtSlot()
    def run(self):
        self.running = True
        print("Thread Running ...")
        while self.running:
            # 请求主线程发送最新UI状态
            self.request_state.emit()
            # 短休眠减少CPU占用，同时给信号槽留处理时间
            QtCore.QThread.msleep(100)
            if self._chkb_state and self._gpb_state:
                print("running ...")
                QtCore.QThread.sleep(3)

    @QtCore.pyqtSlot(bool)
    def set_running(self, value):
        self.running = value
        if not value:
            print("Thread Stopped ...")

    @QtCore.pyqtSlot(bool, bool)
    def _update_state(self, chkb, gpb):
        self._chkb_state = chkb
        self._gpb_state = gpb

if __name__ == "__main__":
    import sys
    app = QtWidgets.QApplication(sys.argv)
    hWindow = HWindow()  
    hWindow.show()
    sys.exit(app.exec_())

关键改进点 #

• 阻塞逻辑移到子线程：把原来的myFunction循环逻辑放到Worker的run方法中，避免主线程被阻塞。
• 信号槽实现安全通信：
  • Worker通过request_state信号请求主线程获取UI状态
  • 主线程通过update_ui_state信号把UI状态传递给Worker
  • 完全避免子线程直接访问GUI控件
• 线程安全控制：用running标志位控制循环启停，替代不安全的terminate方法，让线程自行退出循环。
• 替换time.sleep：使用QtCore.QThread.sleep/msleep，保证线程内的信号槽能正常处理，避免完全阻塞线程。

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