如何在Python PyQt5中向工作线程传递GUI输入变量？

在PyQt中，工作线程绝对不能直接访问GUI元素（这会引发线程安全问题，导致程序崩溃或行为异常），要把GUI输入传递给Worker，有两种常用的可靠方式：

1. 创建Worker实例时直接传入参数 #

这种方式适合在启动线程前就能确定需要传递的数据，步骤清晰直接：

• 修改Worker的构造函数，接收需要的输入参数并保存为实例变量
• 在主线程的runLongTask方法中，先获取GUI输入，再传给Worker

修改后的代码示例：

from PyQt5.QtCore import QObject, pyqtSignal, QThread
from time import sleep

class Worker(QObject):
    finished = pyqtSignal()
    
    # 构造函数接收需要的参数
    def __init__(self, firstname):
        super().__init__()
        self.firstname = firstname  # 保存为实例变量供run方法使用
    
    def run(self):
        # 直接使用预先传入的参数，无需访问GUI
        for i in range(10):
            sleep(1)
            print(self.firstname)
        self.finished.emit()

class MyAPP(QDialog):
    def __init__(self,parent=None):
        super().__init__(parent)
        self.setFixedSize(1180, 850)
        self.ui = Ui_Dialog()
        self.ui.setupUi(self)
        # 原代码遗漏ui前缀，修正为正确的控件引用
        self.ui.runWorkerBtn.clicked.connect(self.runLongTask)

    def runLongTask(self):
        # 主线程中获取GUI输入
        firstname = self.ui.firstname.text()
        
        self.thread = QThread()
        # 创建Worker时传入参数
        self.worker = Worker(firstname)
        self.worker.moveToThread(self.thread)
       
        self.thread.started.connect(self.worker.run)
        self.worker.finished.connect(self.thread.quit)
        self.worker.finished.connect(self.worker.deleteLater)
        self.thread.finished.connect(self.thread.deleteLater)
        self.thread.start()

2. 通过信号槽传递参数 #

如果需要在Worker运行过程中动态传递数据（比如用户在任务执行时更新了输入），可以用PyQt的信号机制实现：

• 在Worker中定义接收参数的槽函数
• 在主线程中定义发送参数的信号
• 将信号与槽绑定，启动线程前后发送数据

示例代码：

from PyQt5.QtCore import QObject, pyqtSignal, pyqtSlot, QThread
from time import sleep

class Worker(QObject):
    finished = pyqtSignal()
    
    # 定义接收参数的槽函数
    @pyqtSlot(str)
    def set_firstname(self, firstname):
        self.firstname = firstname
    
    def run(self):
        # 确保参数已被设置后再执行逻辑
        if hasattr(self, 'firstname'):
            for i in range(10):
                sleep(1)
                print(self.firstname)
        self.finished.emit()

class MyAPP(QDialog):
    # 定义发送参数的信号
    send_firstname = pyqtSignal(str)
    
    def __init__(self,parent=None):
        super().__init__(parent)
        self.setFixedSize(1180, 850)
        self.ui = Ui_Dialog()
        self.ui.setupUi(self)
        self.ui.runWorkerBtn.clicked.connect(self.runLongTask)

    def runLongTask(self):
        self.thread = QThread()
        self.worker = Worker()
        self.worker.moveToThread(self.thread)
        
        # 绑定主线程信号与Worker的槽函数
        self.send_firstname.connect(self.worker.set_firstname)
       
        self.thread.started.connect(self.worker.run)
        self.worker.finished.connect(self.thread.quit)
        self.worker.finished.connect(self.worker.deleteLater)
        self.thread.finished.connect(self.thread.deleteLater)
        
        # 发送GUI输入给Worker
        self.send_firstname.emit(self.ui.firstname.text())
        
        self.thread.start()

关键注意事项 #

• 始终在主线程中获取GUI元素的内容，绝对不要在工作线程中调用self.ui.xxx.text()这类方法
• 工作线程只能处理数据逻辑，不能进行任何GUI相关操作（比如更新UI控件），如果需要更新UI，要通过信号发送数据到主线程，由主线程处理

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