Qt Waiting Spinner不显示问题：耗时任务时如何让加载动画生效

使用QtWaitingSpinner时，将加载动画的父组件设为已显示的QTabWidget页面。点击按钮添加新页面时，新页面初始化需5-10秒，期间设置tabVisible=False，此时启动的加载动画无法正常显示；只有当新页面添加完成并设为可见后，动画才会显示并运转。核心原因是耗时的while循环阻塞了Qt事件循环，导致UI无法刷新渲染。

方法1：使用QThread将耗时任务移至后台线程（推荐） #

Qt的事件循环运行在主线程，耗时操作会阻塞主线程导致UI冻结。将新页面的初始化逻辑放到子线程执行，主线程仅负责UI操作（启动动画、添加标签页、控制可见性），这是Qt处理耗时任务的标准方式。

修改后的完整代码 #

import sys
from time import monotonic, sleep

from PyQt6.QtWidgets import (
    QApplication,
    QMainWindow,
    QPushButton,
    QTabWidget,
    QVBoxLayout,
    QWidget,
)
from PyQt6.QtCore import QThread, pyqtSignal
from waitingspinnerwidget import QtWaitingSpinner

class PageInitThread(QThread):
    # 定义任务完成信号，传递新页面索引
    init_finished = pyqtSignal(int)

    def __init__(self, page_index):
        super().__init__()
        self.page_index = page_index

    def run(self):
        # 模拟耗时的页面初始化操作
        t = monotonic()
        while monotonic() - t < 5.0:
            # 替换为实际的初始化逻辑
            sleep(0.01)  # 避免空循环占用过多CPU
        self.init_finished.emit(self.page_index)

class MyWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.resize(400, 400)
        self.setWindowTitle("Spinner test")
        layout = QVBoxLayout()
        self._tab = QTabWidget(self)

        _page_1 = QWidget()
        self._page_index = self._tab.addTab(_page_1, "Page with the spinner")
        layout.addWidget(self._tab)
       
        btn_add_page = QPushButton()
        btn_add_page.setText("Add a page")
        btn_add_page.clicked.connect(self.add_new_page)
        layout.addWidget(btn_add_page)
        
        widget = QWidget()
        widget.setLayout(layout)
        self.setCentralWidget(widget)

        self.spinner = None
        self.init_thread = None
        
    def add_new_page(self):
        _new_index = self._page_index + 1
        widget = QWidget()
        widget.setObjectName(f"page_{_new_index}")
        # 启动加载动画，父组件为当前可见的页面
        self.start_spinner()

        # 添加新标签页并设置为不可见
        self._page_index = self._tab.addTab(widget, f"Page no {_new_index}")
        self._tab.setTabVisible(self._page_index, False)

        # 启动子线程执行耗时初始化
        self.init_thread = PageInitThread(_new_index)
        self.init_thread.init_finished.connect(self.on_page_init_finished)
        self.init_thread.start()

    def on_page_init_finished(self, page_index):
        # 初始化完成后显示标签页、切换页面并停止动画
        self._tab.setTabVisible(page_index, True)
        self._tab.setCurrentIndex(page_index)
        self.stop_spinner()
        # 释放线程资源
        self.init_thread.quit()
        self.init_thread.wait()
        self.init_thread = None

    def start_spinner(self):
        # 确保动画父组件是当前活跃的可见页面
        current_page = self._tab.currentWidget()
        self.spinner = QtWaitingSpinner(parent=current_page)
        self.spinner.start()

    def stop_spinner(self):
        if self.spinner:
            self.spinner.stop()
            self.spinner.deleteLater()
            self.spinner = None

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MyWindow()
    window.show()
    sys.exit(app.exec())

方法2：在耗时循环中手动处理事件（仅适合简单场景） #

如果不想使用线程，可以在while循环中定期调用QApplication.processEvents()，强制Qt处理UI刷新事件。但这种方法会导致代码耦合，若循环逻辑复杂可能引发UI响应异常，仅推荐临时调试或简单场景使用。

修改后的add_new_page方法示例 #

def add_new_page(self):
    _new_index = self._page_index + 1
    widget = QWidget()
    widget.setObjectName(f"page_{_new_index}")
    self.start_spinner()

    self._page_index = self._tab.addTab(widget, f"Page no {_new_index}")
    self._tab.setTabVisible(self._page_index, False)

    t = monotonic()
    while monotonic() - t < 5.0:
        # 模拟耗时操作，同时定期处理UI事件
        QApplication.processEvents()
        sleep(0.01)  # 减少CPU占用

    self._tab.setTabVisible(self._page_index, True)
    self._tab.setCurrentIndex(self._page_index)
    self.stop_spinner()

• 线程方案是最优解：完全分离UI线程与耗时任务，避免阻塞事件循环，保证UI流畅响应。
• 动画父组件需为可见页面：确保加载动画显示在当前用户可见的标签页上，避免将动画绑定到不可见的新页面。
• 线程资源需正确释放：线程完成后调用quit()和wait()，避免内存泄漏。

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