如何正确显示QSplashScreen？启动闪屏异常问题求助

启动程序时无法正常显示QSplashScreen闪屏以等待初始化完成，相关代码参考Qt文档编写如下：

from PyQt6 import uic, QtWidgets, QtCore, QtGui
import sys

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        ... # 此处为耗时数秒的XML文件加载解析逻辑

def main():
    app = QtWidgets.QApplication(sys.argv)
    pixmap = QtGui.QPixmap('resources/dark-arisen.jpg')
    splash = QtWidgets.QSplashScreen(pixmap)
    splash.show()
    app.processEvents()
    mw = MainWindow()
    mw.show()
    splash.finish(mw)
    sys.exit(app.exec())

if __name__ == "__main__":
    main()

由于MainWindow.__init__()需要加载解析较大的XML文件，耗时数秒。目前问题是调用app.processEvents()后，闪屏完全不显示，直到初始化完成后才短暂闪烁一下，随即主界面弹出。使用的是Linux Debian/Cinnamon系统，请问忽略了什么？

问题出在两个核心点：

• 单次app.processEvents()不足以让系统完成闪屏的渲染绘制，Linux窗口管理器的渲染调度需要一定时间窗口。
• 耗时的初始化操作完全阻塞主线程，导致Qt事件循环无法持续处理界面刷新事件。

可通过两种方式修复：

方法一：在初始化过程中持续处理事件 #

修改MainWindow.__init__，在耗时操作的关键节点定期调用QtWidgets.QApplication.processEvents()，确保闪屏能持续刷新：

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 示例：分步加载XML，每处理一部分就处理一次事件
        xml_chunks = self.split_large_xml('big_file.xml')
        for chunk in xml_chunks:
            self.process_xml_chunk(chunk)
            # 处理所有待处理事件，包括闪屏刷新
            QtWidgets.QApplication.processEvents()

方法二：将耗时初始化移到子线程 #

更规范的做法是把耗时的XML解析放到子线程中，避免阻塞主线程的事件循环：

from PyQt6.QtCore import QThread, pyqtSignal

class XmlLoader(QThread):
    finished = pyqtSignal(object) # 传递解析后的数据

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

    def run(self):
        # 在这里执行耗时的XML解析
        parsed_data = self.parse_large_xml(self.xml_path)
        self.finished.emit(parsed_data)

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 先初始化界面框架，不做耗时操作
        self.init_ui_frame()

    def init_ui_with_data(self, parsed_data):
        # 用解析好的数据填充界面
        self.setup_ui_content(parsed_data)
        self.show()

def main():
    app = QtWidgets.QApplication(sys.argv)
    pixmap = QtGui.QPixmap('resources/dark-arisen.jpg')
    splash = QtWidgets.QSplashScreen(pixmap)
    splash.show()

    # 启动子线程加载XML
    loader = XmlLoader('big_file.xml')
    mw = MainWindow()

    def on_load_finished(data):
        mw.init_ui_with_data(data)
        splash.finish(mw)

    loader.finished.connect(on_load_finished)
    loader.start()

    sys.exit(app.exec())

额外注意事项 #

• Linux环境下，Qt窗口渲染依赖窗口管理器同步，需确保闪屏的QPixmap路径正确、图片格式无损坏（如JPG文件正常）。
• 若使用方法一，避免过于频繁调用processEvents()，防止影响初始化效率，可每处理一定量的数据后调用一次。

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