PyQt5并行运行两个函数时GUI崩溃无响应问题求助

核心问题原因 #

你的代码导致GUI崩溃无响应，主要是三个关键错误：

1. 子线程直接操作GUI控件：Qt的GUI元素只能由主线程（创建它们的线程）修改，子线程里调用self.ui.progressBar.setProperty、self.set_back_buttons_to_enable()等操作会引发线程冲突，破坏GUI线程的稳定性。
2. 无休眠的循环占用CPU：update_progressbar_with_timer里的while True循环没有任何休眠，会让子线程持续占用大量CPU，导致主线程无法及时处理GUI事件，出现假死。
3. 滥用QGuiApplication.processEvents()：在子线程调用该方法会打乱Qt的事件循环逻辑，进一步加剧GUI线程的不稳定。

修复方案：用信号槽+Qt定时器替代子线程操作GUI #

Qt的信号槽机制是线程安全的，子线程只需发送信号，主线程接收后执行GUI更新操作；同时用QTimer替代手动循环计时，符合Qt的事件驱动模型。

步骤1：在类中定义信号

首先在你的窗口类里添加Qt信号，用于子线程和主线程通信：

from PyQt5.QtCore import pyqtSignal, QTimer, QObject

class YourWindowClass(QObject):
    # 定义信号：更新进度条、下载完成、下载出错
    update_progress_signal = pyqtSignal(int)
    download_finished_signal = pyqtSignal()
    download_error_signal = pyqtSignal(str)

    def __init__(self):
        super().__init__()
        # 连接信号到对应的槽函数
        self.update_progress_signal.connect(self.ui.progressBar.setValue)
        self.download_finished_signal.connect(self.handle_download_finished)
        self.download_error_signal.connect(self.handle_download_error)
        # 初始化进度计时器
        self.progress_timer = QTimer()
        self.progress_timer.timeout.connect(self.update_progress_periodically)
        self.current_progress_step = 0

步骤2：重构并行执行逻辑

启动下载线程的同时，在主线程启动定时器更新进度：

def run_functions_in_parallel(self):
    self.disable_button()
    self.current_progress_step = 0
    self.ui.status_lbl.setText("正在下载...")
    # 每10秒更新一次进度
    self.progress_timer.start(10000)
    # 启动下载子线程
    import threading
    t1 = threading.Thread(target=self.Download_dummy_video)
    t1.daemon = True  # 设置为守护线程，程序退出时自动结束
    t1.start()

步骤3：主线程处理进度更新

def update_progress_periodically(self):
    self.current_progress_step += 1
    # 计算进度（按30步对应100%，对应2-3分钟的下载时长）
    progress = min(round(((self.current_progress_step + 1) / 30) * 100), 100)
    self.update_progress_signal.emit(progress)

步骤4：修改下载函数，用信号通知状态

def Download_dummy_video(self):
    try:
        # 这里执行实际的下载操作
        Download_dummy_video()
        # 下载完成，发送信号给主线程
        self.download_finished_signal.emit()
    except Exception as ex:
        error_msg = f"下载失败：{str(ex)}"
        self.download_error_signal.emit(error_msg)
        print(error_msg)

步骤5：主线程处理下载完成/出错事件

def handle_download_finished(self):
    self.progress_timer.stop()
    self.update_progress_signal.emit(100)
    self.set_back_buttons_to_enable()
    self.ui.status_lbl.setText("视频下载完成...")

def handle_download_error(self, error_msg):
    self.progress_timer.stop()
    self.set_back_buttons_to_enable()
    self.ui.status_lbl.setText(error_msg)

关键注意点 #

• 所有GUI操作必须放在主线程，子线程只负责耗时的后台任务（如下载），通过信号传递状态。
• 使用QTimer替代手动循环计时，既节省CPU资源，又符合Qt的事件驱动设计。
• 给子线程设置daemon=True，避免程序退出时残留后台线程。

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