PyQt运行耗时任务时进度条不显示但任务正常执行问题求助

问题原因 #

Qt的UI渲染、事件响应逻辑全部运行在主线程的事件循环中，你当前直接将耗时的run函数绑定到按钮点击信号，触发后会在主线程执行，直接阻塞了事件循环，导致setValue触发的进度条重绘请求无法被实时处理，只有等整个函数执行完成后才会一次性更新UI，因此看不到运行过程中的进度变化。

修复方案 #

你可以根据使用场景选择以下两种方案：

方案1：临时强制处理事件（仅适合简单测试场景） #

仅修改run函数即可，每次更新进度后强制处理主线程积压的UI事件：

def run(self, n):
    for i in range(n):
        time.sleep(.05)
        self.ui.progressBar.setValue(i+1)
        # 新增：强制处理当前所有积压事件，包含UI重绘请求
        QApplication.processEvents()

注意：该方案仅适合简单测试，如果实际业务函数存在单段超过数百毫秒的阻塞逻辑，仍然会出现UI卡顿，且无法避免重复点击触发多次任务的问题

方案2：子线程执行耗时任务+信号槽更新进度（生产环境推荐） #

这种方式完全不会阻塞主线程，UI全程响应流畅，需要同时调整run函数逻辑和主逻辑：

1. 首先新增继承自QThread的工作线程类，将耗时逻辑移到子线程，通过信号通知主线程更新进度：

from PyQt5.QtCore import QThread, pyqtSignal
import time

class WorkerThread(QThread):
    # 定义进度更新信号，参数为当前进度值
    progress_updated = pyqtSignal(int)
    def __init__(self, n, parent=None):
        super().__init__(parent)
        self.n = n
    
    def run(self):
        # 此处替换为你的实际业务逻辑，每完成一部分进度就触发一次progress_updated信号
        for i in range(self.n):
            time.sleep(.05)
            self.progress_updated.emit(i+1)

2. 修改主逻辑的按钮绑定逻辑，启动子线程执行任务，绑定信号更新进度条：

def run_gui(self):
    self.ui.progressBar = QProgressBar()
    n = 50
    self.ui.progressBar.setMinimum(0)
    self.ui.progressBar.setMaximum(n)
    layout = QVBoxLayout()
    layout.addWidget(self.ui.progressBar)
    # 修改按钮点击绑定逻辑
    self.ui.pb_tester_connect_disconnect.clicked.connect(self.start_task)

# 新增任务启动槽函数
def start_task(self):
    # 禁用按钮避免重复触发任务
    self.ui.pb_tester_connect_disconnect.setEnabled(False)
    # 实例化工作线程
    self.worker = WorkerThread(n=50)
    # 绑定进度更新信号到进度条更新方法
    self.worker.progress_updated.connect(self.ui.progressBar.setValue)
    # 任务执行完成后恢复按钮可用
    self.worker.finished.connect(lambda: self.ui.pb_tester_connect_disconnect.setEnabled(True))
    # 启动线程执行任务
    self.worker.start()

后续你要替换业务逻辑，只需要修改WorkerThread类的run方法内容即可，不需要调整其他框架代码。

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