Python PyQt主线程运行耗时任务时如何让子线程正常更新进度条

你遇到的阻塞现象本质是Qt主线程的事件循环被长耗时同步函数占住导致的：

• 你创建的ProgressThread本身是正常独立运行的，每秒都在正常发送更新进度的信号
• Qt跨线程的信号默认是队列连接模式，信号发出后会进入主线程的事件队列等待调度
• 你主线程全程卡在long_analysis_function()上，没有空闲时间处理事件队列里的更新请求，所有信号都会积压到分析函数执行完成后才统一处理，就会出现进度条跳变的情况。

另外你的代码里有一个小语法错误：ProgressThread的初始化方法里，super()的第一个参数应该是当前类名ProgressThread而不是Thread，否则会触发NameError报错。

方案1：可修改long_analysis_function内部逻辑（首选） #

在分析函数的执行逻辑里，每隔1秒以内的间隔主动调用QCoreApplication.processEvents()，让主线程抽空处理积压的UI事件：

from PyQt5.QtCore import QCoreApplication

def long_analysis_function():
    # 你的原有分析逻辑
    for step in 分析任务步骤:
        # 执行当前步骤的分析任务
        run_current_step(step)
        # 主动让出时间片处理事件，包括进度条更新、窗口交互等
        QCoreApplication.processEvents()

只要processEvents()的调用间隔不超过0.5秒，用户完全感知不到UI卡顿，进度条也会正常更新。

方案2：无法修改long_analysis_function内部逻辑 #

如果分析函数是第三方库提供的、无法插入processEvents()调用，可以采用异步分片调度的方式改造主线程的执行逻辑：
将原本连续执行的分析函数调用放到QTimer的回调中，每次执行一小段任务后就把控制权交还给事件循环，不过这种方案仅适用于可拆分执行步骤的分析任务。

如果分析函数是完全不可拆分的同步阻塞函数，没有任何办法在不阻塞UI的情况下在主线程运行，这种场景下只能考虑将分析函数依赖的主线程资源（比如UI操作）封装成线程安全的信号槽调用，再把分析函数移到子线程执行。

• 调用processEvents()时不要额外添加ExcludeUserInputEvents之类的过滤标志，否则会导致窗口拖动、按钮点击等交互也被阻塞
• 不要在processEvents()执行期间触发重复调用分析函数的逻辑，避免出现递归调用导致栈溢出

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