QGIS运行Python进度脚本时频繁冻结，如何解决？

哎，这个问题我碰到好多次了！你的进度条卡在半路上本质上是因为**time.sleep()阻塞了QGIS的UI主线程**——QGIS的界面更新全靠主线程处理事件，你把主线程sleep住了，它根本没时间去刷新进度条的显示，自然就看起来“冻结”了。

给你两种靠谱的解决方案：

方案一：手动触发UI事件更新（简单快捷） #

在循环里每次更新进度后，调用QCoreApplication.processEvents()，让UI线程有机会处理进度条的刷新事件。修改后的代码如下：

import time
from qgis.PyQt.QtWidgets import QProgressBar
from qgis.PyQt.QtCore import Qt, QCoreApplication
from qgis.core import Qgis

progressMessageBar = iface.messageBar().createMessage("Doing something boring...")
progress = QProgressBar()
progress.setMaximum(10)
progress.setAlignment(Qt.AlignLeft|Qt.AlignVCenter)
progressMessageBar.layout().addWidget(progress)
iface.messageBar().pushWidget(progressMessageBar, Qgis.Info)

for i in range(10):
    time.sleep(1)
    progress.setValue(i + 1)
    # 关键：让UI线程处理积压的事件，更新进度条显示
    QCoreApplication.processEvents()
    
iface.messageBar().clearWidgets()

这个方法适合简单的短任务，代码改动最小，马上就能见效。

方案二：用子线程执行耗时操作（规范专业） #

如果你的实际任务比time.sleep()更耗时，推荐用QThread把耗时逻辑放到子线程里，彻底避免阻塞主线程。示例代码如下：

from qgis.PyQt.QtWidgets import QProgressBar
from qgis.PyQt.QtCore import Qt, QThread, pyqtSignal
from qgis.core import Qgis
import time

# 定义子线程类，专门执行耗时操作
class WorkerThread(QThread):
    # 定义信号，用来向主线程发送进度更新
    progress_updated = pyqtSignal(int)
    
    def run(self):
        # 这里替换成你的实际耗时任务
        for i in range(10):
            time.sleep(1)
            # 发送当前进度给主线程
            self.progress_updated.emit(i + 1)

# 主逻辑部分
progressMessageBar = iface.messageBar().createMessage("Doing something boring...")
progress = QProgressBar()
progress.setMaximum(10)
progress.setAlignment(Qt.AlignLeft|Qt.AlignVCenter)
progressMessageBar.layout().addWidget(progress)
iface.messageBar().pushWidget(progressMessageBar, Qgis.Info)

# 创建线程实例并连接信号
worker = WorkerThread()
worker.progress_updated.connect(progress.setValue)
# 线程结束后自动清理消息栏
worker.finished.connect(lambda: iface.messageBar().clearWidgets())

# 启动线程
worker.start()

这种方式更符合Qt的UI编程规范，适合复杂的长时间任务，能保证QGIS界面全程响应流畅，不会出现卡顿或冻结。

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