使用PySide6/PyQt6实现程序启动画面的处理

在 PySide6 / PyQt6 或其他 GUI 程序中，启动画面主要有以下几个作用：提升用户体验，当主程序初始化需要几秒钟时，如果界面一直空白，用户可能以为程序没响应；品牌展示，常见做法是在启动画面上放置公司 Logo、应用图标、版本号、版权信息；程序架构上的过渡，启动画面在主窗口创建前显示，等主程序准备就绪后再关闭，起到过渡和占位的作用。

1、简单例子代码介绍

在 PySide6 / PyQt6 里要实现启动画面（Splash Screen），通常可以用 QSplashScreen 来完成，和 wx.adv.SplashScreen 类似。它的主要作用是在主窗口加载前，先显示一个过渡画面（通常放 logo、版本号、加载提示）。

简单的案例代码如下所示。

def main():
 app = QApplication(sys.argv)
 # 创建启动画面
 pixmap = QPixmap(400, 300) # 可以替换为 QPixmap("logo.png")
 pixmap.fill(Qt.white) # 这里用纯白背景
 splash = QSplashScreen(pixmap)
 splash.showMessage("正在加载，请稍候...", Qt.AlignBottom | Qt.AlignCenter, Qt.black)
 splash.show()
 # 模拟加载过程（比如初始化数据库、加载配置等）
 for i in range(1, 6):
 splash.showMessage(f"正在加载资源 {i}/5 ...", Qt.AlignBottom | Qt.AlignCenter, Qt.black)
 app.processEvents() # 让界面刷新
 time.sleep(0.5)
 # 加载完成后进入主窗口
 window = MainWindow()
 # 延迟关闭启动画面并显示主窗口
 QTimer.singleShot(500, lambda: (
 splash.finish(window),
 window.show()
 ))
 sys.exit(app.exec())
if __name__ == "__main__":
 main()

关键点：

QSplashScreen
- 通过 QSplashScreen(QPixmap) 创建。
- showMessage(text, alignment, color) 用来显示提示信息。
- finish(widget) 在主窗口准备好后关闭 Splash，并显示目标窗口。
app.processEvents()
- 在耗时操作中调用，确保 Splash 画面能刷新，不会卡死。
QTimer.singleShot()
- 可以避免界面卡顿，等初始化完成后关闭启动画面。

2、我使用PySide6/PyQt6实现程序启动画面

参照上面的过程，我们可以改进下程序启动画面，并结合程序初始化等过程进行展示。

我们在程序登录界面展示，用户确认登录成功后，提示启动画面的。

用户登录成功后，闪屏启动页面进行展示

实现过程也是和上面的例子类似，不过增加了一些特殊的处理。

首先封装好显示闪屏界面的函数，如下所示。

def show_splash_screen():
 """显示启动闪屏"""
 splash_pix = QPixmap("app/images/splash.png")
 splash = QSplashScreen(splash_pix, Qt.WindowType.WindowStaysOnTopHint)
 # 设置字体
 font = QFont("Arial", 20, QFont.Weight.Bold)
 splash.setFont(font)
 splash.showMessage(
 "正在加载，请稍候...",
 Qt.AlignmentFlag.AlignBottom | Qt.AlignmentFlag.AlignCenter,
 Qt.GlobalColor.yellow,
 )
 splash.show()
 return splash

然后再启动的main.py的main函数中处理各个操作过程即可。

async def init_app():
 app = SystemApp()
 await app.SetLoginInfo()
def main():
 app = QApplication(sys.argv)
 event_loop = QEventLoop(app)
 asyncio.set_event_loop(event_loop)
 app_close_event = asyncio.Event()
 app.aboutToQuit.connect(app_close_event.set)
 app.setStyle("Fusion") # 设置样式# 显示登录窗口
 loginDialog = FrmLogin()
 if loginDialog.exec() != QDialog.DialogCode.Accepted:
 # 如果登录失败或取消，程序退出
 sys.exit(0)
 # 显示闪屏
 splash = show_splash_screen()
 # 主窗口
 main_window = MainWindow()
 # 设置托盘图标
 setup_tray_icon(app, main_window)
 # 闪屏后显示主界面, 1秒后窗口最大化显示
 QTimer.singleShot(1000, lambda: (splash.close(), main_window.showMaximized()))
 # sys.exit(app.exec())
 with event_loop:
 event_loop.create_task(init_app())
 event_loop.run_until_complete(app_close_event.wait())
if __name__ == "__main__":
 main()

我们的主程序使用了异步的操作，因此和上面的例子有所差异，在用户登录成功后，前端会获得相关的用户身份信息，并在 init_app() 函数中进行用户身份信息的获取和设置。

我们把用户身份信息的处理，单独抽取出来，放在system_app类里面进行处理，如下所示，可以根据登录用户的信息，获取用户的当前拥有的功能权限，角色集合等等。