如何实现Python脚本执行时进度条同步迭代更新？

你遇到的核心问题是Qt主线程被阻塞：脚本执行和UI更新都挤在主线程里运行，当脚本开始执行时，主线程被占满，没时间处理进度条的刷新事件，导致进度条直接跳到100%，等脚本跑完才会显示状态变化。

把脚本执行放到独立的子线程中，通过Qt的信号槽机制让子线程给主线程发送进度更新，主线程只负责更新进度条，这样就不会阻塞UI了。

步骤1：定义子线程类 #

这个类负责执行脚本，并发送进度更新信号：

from PyQt5.QtCore import QThread, pyqtSignal
import subprocess

class ScriptThread(QThread):
    # 定义进度更新信号，参数为当前进度值
    progress_update = pyqtSignal(int)
    
    def run(self):
        # 假设脚本需要分100个阶段执行，可根据实际情况调整
        total_steps = 100
        for step in range(total_steps):
            # 执行目标脚本（替换成你的实际脚本调用逻辑）
            subprocess.run(['python', 'Python-Test1.py'], stdout=subprocess.PIPE, stderr=subprocess.PIPE)
            
            # 计算当前进度并发送信号
            current_progress = int((step + 1) / total_steps * 100)
            self.progress_update.emit(current_progress)
            
            # 根据脚本实际执行耗时调整间隔，不需要可删除
            import time
            time.sleep(0.05)

步骤2：在主窗口类中集成线程与进度条 #

修改你的主窗口代码，连接线程信号到进度条更新逻辑：

from PyQt5.QtWidgets import QMainWindow
# 导入Qt Designer生成的UI类，替换成你的实际文件名
from your_ui_file import Ui_MainWindow

class MainWindow(QMainWindow, Ui_MainWindow):
    def __init__(self):
        super().__init__()
        self.setupUi(self)
        
        # 初始化线程
        self.script_thread = ScriptThread()
        # 连接进度信号到进度条的setValue方法
        self.script_thread.progress_update.connect(self.progressBar.setValue)
        
        # 绑定按钮点击事件
        self.your_button.clicked.connect(self.start_script)
    
    def start_script(self):
        # 先重置进度条
        self.progressBar.setValue(0)
        # 检查线程是否在运行，避免重复启动
        if not self.script_thread.isRunning():
            self.script_thread.start()

关键注意事项 #

• 绝对不要在子线程里直接操作UI控件，Qt规定UI操作必须在主线程，用信号槽传递进度是唯一安全的方式。
• 如果你的脚本是一次性执行的（不是循环多次），可以通过监控脚本执行时长，用定时器定期更新进度条；或者拆分脚本的执行步骤，每完成一步发送一次进度信号。
• 避免重复启动线程，每次点击按钮前先判断线程状态。

1. 初始就把进度条设为100，后续执行脚本时UI被阻塞，自然直接显示满格。
2. 循环里重复执行脚本（同时用subprocess.run和exec），进度计算逻辑混乱，导致进度条和脚本执行完全不同步。

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