如何将PyQt5 QWidget类的QLineEdit字符串传递给QThread工作线程

核心思路 #

点击运行按钮时，先在UI线程读取所有QLineEdit的输入内容，得到普通Python类型的参数后，通过信号槽传递给工作线程执行耗时逻辑，工作线程全程不接触任何GUI控件，既规避Qt线程安全问题，也完成了参数传递需求。

完整实现代码 #

from PyQt5 import QtWidgets as qtw
from PyQt5 import QtCore as qtc
from PyQt5.QtWidgets import QInputDialog, QFileDialog, QDialog
from PyQt5 import QtGui
from PyQt5.QtCore import Qt, QObject, QThread, pyqtSignal, pyqtSlot
import geopandas as gpd
from aw_widget import Ui_Areal_Weight
from areal_weight import arealwt

# 新增工作类，所有耗时逻辑放在此处
class ArealWeightWorker(qtc.QObject):
    # 定义跨线程通信信号
    finished = qtc.pyqtSignal()
    error = qtc.pyqtSignal(str)

    @pyqtSlot(str, str, list, str, str)
    def run(self, src_path, target_path, intp_fields, suffix, save_path):
        try:
            src = gpd.read_file(src_path)
            target = gpd.read_file(target_path)
            outp = arealwt(src, target, intp_fields, suffix)
            outp.to_file(save_path)
            self.finished.emit()
        except Exception as e:
            self.error.emit(str(e))

class aw(qtw.QWidget):    
    def __init__(self):
        super().__init__()
        self.ui = Ui_Areal_Weight()
        self.ui.setupUi(self)
        self.ui.aw_source_browse.clicked.connect(self.source_browser)
        self.ui.aw_target_browse.clicked.connect(self.target_browser)
        self.ui.aw_save_browse.clicked.connect(self.save_browser)
        self.ui.aw_run_prog.clicked.connect(self.run_aw)
        self.ui.aw_cancel_prog.clicked.connect(self.close_aw)
        title = "Areal Weighting Method"
        self.setWindowTitle(title)
    def source_browser(self):
        self.filename = QFileDialog.getOpenFileName()
        self.ui.aw_source_lineedit.setText(self.filename[0])  
    def target_browser(self):
        self.filename = QFileDialog.getOpenFileName()
        self.ui.aw_target_lineedit.setText(self.filename[0])    
    def save_browser(self):
        self.filename = QFileDialog.getSaveFileName()
        self.ui.aw_save_lineedit.setText(self.filename[0])              
    def run_aw(self):
        # UI线程读取所有输入参数
        src = self.ui.aw_source_lineedit.text().strip()
        target = self.ui.aw_target_lineedit.text().strip()
        intp = self.ui.aw_intp_fields.text().strip()
        intp_list = intp.split()
        suffix = self.ui.aw_output_suffix.text().strip()
        save = self.ui.aw_save_lineedit.text().strip()

        # 前置非空校验
        if not all([src, target, intp, save]):
            qtw.QMessageBox.critical(self, '错误', '请填写所有必填字段')
            return
        
        # 禁用运行按钮避免重复提交
        self.ui.aw_run_prog.setDisabled(True)

        # 初始化线程和工作对象
        self.aw_thread = QThread()
        self.aw_worker = ArealWeightWorker()
        self.aw_worker.moveToThread(self.aw_thread)

        # 绑定信号槽
        self.aw_thread.started.connect(lambda: self.aw_worker.run(src, target, intp_list, suffix, save))
        # 任务结束后自动销毁对象
        self.aw_worker.finished.connect(self.aw_thread.quit)
        self.aw_worker.finished.connect(self.aw_worker.deleteLater)
        self.aw_thread.finished.connect(self.aw_thread.deleteLater)
        # 成功回调
        self.aw_worker.finished.connect(lambda: qtw.QMessageBox.information(self, '成功', '面积加权计算完成'))
        # 错误回调
        self.aw_worker.error.connect(lambda err: qtw.QMessageBox.critical(self, '错误', f'计算失败：{err}'))
        # 恢复按钮可用
        self.aw_worker.finished.connect(lambda: self.ui.aw_run_prog.setDisabled(False))
        self.aw_worker.error.connect(lambda: self.ui.aw_run_prog.setDisabled(False))

        # 启动线程
        self.aw_thread.start()
    def close_aw(self):
        self.close()

关键逻辑说明 #

• 所有GUI控件的读写操作都必须在UI线程完成，这里在点击运行时直接读取所有输入框内容，转换为普通Python变量后传递给工作线程，完全不需要在子线程中访问GUI对象。
• 使用lambda表达式可以便捷地将读取到的参数传递给工作线程的执行方法，不需要额外的中间存储对象。
• 工作线程只执行耗时的文件读写、计算逻辑，执行结果通过信号返回给UI线程做弹窗提示等界面操作，符合Qt线程安全规范。
• 线程和工作对象绑定了自动销毁逻辑，同时控制运行按钮的状态，避免内存泄漏和用户重复提交任务的问题。

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