PyQt6中QMainWindow控件无法显示问题求助

问题根源 #

闪屏窗口在子模块调用时显示空白，核心原因是主线程被time.sleep()阻塞，Qt事件循环无法处理界面渲染事件。

在SplashScreen的__init__方法中，调用self.show()后立刻进入time.sleep()循环，这会卡住主线程，导致界面绘制、控件渲染等事件无法被处理，最终显示空白。而单独运行UI文件时，末尾的app.exec()启动了完整的事件循环，所以界面能正常渲染。

解决方案 #

方案1：手动触发事件处理（快速修复） #

在每次time.sleep()前，强制让Qt处理所有待完成的事件，确保界面能及时渲染：

import sys 
from PyQt6 import QtCore, QtWidgets, QtGui
from thinclient.ui.launcher.splashScreen import Ui_MainWindow as splashScreen_MainWindow
import time

class SplashScreen(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()

        self.ui = splashScreen_MainWindow()
        self.ui.setupUi(self)
        self.show()

        for i in range(20,101,20):
            # self.ui.progressBar.setValue(i)
            QtWidgets.QApplication.processEvents()  # 处理界面渲染事件
            time.sleep(2)

方案2：使用QTimer异步更新（推荐） #

遵循Qt的异步编程模式，用QTimer替代time.sleep()，避免阻塞主线程：

import sys 
from PyQt6 import QtCore, QtWidgets, QtGui
from thinclient.ui.launcher.splashScreen import Ui_MainWindow as splashScreen_MainWindow

class SplashScreen(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        self.ui = splashScreen_MainWindow()
        self.ui.setupUi(self)
        self.show()
        
        self.progress_step = 20
        self.current_progress = self.progress_step
        
        # 创建定时器，每2秒触发一次进度更新
        self.timer = QtCore.QTimer(self)
        self.timer.timeout.connect(self.update_splash_progress)
        self.timer.start(2000)

    def update_splash_progress(self):
        if self.current_progress <= 100:
            # self.ui.progressBar.setValue(self.current_progress)
            self.current_progress += self.progress_step
        else:
            self.timer.stop()
            # 此处可添加闪屏关闭、跳转主界面的逻辑

原理说明 #

• Qt的UI渲染依赖事件循环处理绘制事件，主线程一旦被阻塞（比如time.sleep()），事件循环就会暂停，界面无法更新。
• QApplication.processEvents()会强制处理当前所有待处理的事件，让界面完成渲染后再执行后续代码。
• QTimer通过异步触发回调函数，不会阻塞主线程，事件循环可以持续处理界面事件，保证控件正常显示。

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