PyQt5实现与QMainWindow并行启动的QSplashScreen问题

你的问题核心在于主窗口的初始化逻辑阻塞了主线程，导致启动画面无法立即渲染。要实现启动画面与主窗口并行加载，需要将耗时的主窗口初始化操作放到子线程中，同时让主线程优先处理启动画面的显示事件。

修正后的实现代码 #

1. 启动画面类优化

import sys
from PyQt5 import QtWidgets, QtCore, QtGui
from your_ui_module import myWindow  # 替换为你的UI模块路径

class SplashScreen(QtWidgets.QSplashScreen):
    def __init__(self):
        # 空Pixmap会导致启动画面不可见，这里设置深色背景替代
        super().__init__(QtGui.QPixmap())
        self.setStyleSheet("background-color: #2c3e50;")
        
        # 配置加载文本
        self.font = QtGui.QFont()
        self.font.setPointSize(16)
        self.font.setBold(True)
        
        self.text_label = QtWidgets.QLabel("程序加载中...", self)
        self.text_label.setFont(self.font)
        self.text_label.setAlignment(QtCore.Qt.AlignCenter)
        self.text_label.setStyleSheet("color: white;")
        
        # 使用布局确保文本居中，避免位置偏移问题
        layout = QtWidgets.QVBoxLayout(self)
        layout.addStretch()
        layout.addWidget(self.text_label)
        layout.addStretch()
        self.setLayout(layout)

2. 主窗口异步加载逻辑

class MainWindowLoader(QtCore.QThread):
    # 线程完成信号，传递初始化好的主窗口对象
    load_finished = QtCore.pyqtSignal(object)

    def run(self):
        # 这里执行所有耗时的初始化操作（UI创建、数据加载等）
        # 注意：UI对象创建仍需在主线程？不，QMainWindow可以在子线程创建，但show必须在主线程
        main_window = QtWidgets.QMainWindow()
        ui = myWindow()
        ui.setupUi(main_window)
        
        # 模拟耗时操作（替换为你的实际业务逻辑，比如加载配置、数据库连接）
        # import time
        # time.sleep(3)
        
        self.load_finished.emit(main_window)

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)
    
    # 显示启动画面并立即处理事件，确保画面渲染
    splash = SplashScreen()
    splash.show()
    app.processEvents()

    # 启动子线程加载主窗口
    loader = MainWindowLoader()
    
    def on_load_finished(main_window):
        main_window.show()
        # 主窗口显示后自动关闭启动画面
        splash.finish(main_window)
    
    loader.load_finished.connect(on_load_finished)
    loader.start()

    sys.exit(app.exec_())

关键优化点说明 #

• 立即渲染启动画面：调用app.processEvents()强制主线程处理显示事件，避免启动画面被后续初始化逻辑阻塞。
• 异步加载主窗口：将耗时的setupUi及业务初始化逻辑放到QThread子线程中，主线程专注于保持启动画面的响应。
• 线程安全的UI交互：子线程仅负责初始化主窗口对象，最终的show()操作仍在主线程执行，符合PyQt的UI线程安全要求。
• 启动画面可见性修复：为空Pixmap添加背景色，避免启动画面因无内容而无法显示。

额外建议 #

• 如果setupUi本身耗时极长，可考虑将其中的非UI逻辑（如数据加载、资源读取）拆分到子线程，UI组件创建仍保留在主线程。
• 编译exe时，确保启动画面的资源（如背景图）被正确打包（可使用PyInstaller的--add-data参数）。

内容的提问来源于stack exchange，提问作者Nene Tetteh Wayo Akwetteh