如何避免初始化QWebEngineView时出现白屏闪烁？

问题分析 #

首次调用setHtml时，QWebEngineView依赖的Chromium内核进程需要启动，加上后续阻塞主线程的GUI初始化代码，会导致整个应用无法及时刷新，出现全局白闪；第二次加载时内核已就绪，因此仅控件区域闪烁。

解决方案 #

方案1：预加载内核进程，避免首次启动阻塞

在应用启动时提前初始化一个隐藏的QWebEngineView，触发内核进程启动，后续创建可用控件时内核已就绪，不会阻塞主线程导致全局闪烁。

import sys
import time
from PyQt6.QtWidgets import QApplication, QMainWindow, QVBoxLayout, QWidget, QPushButton
from PyQt6.QtWebEngineWidgets import QWebEngineView

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setGeometry(100, 100, 400, 400)
        self.setStyleSheet('background:gray')
        self.statusBar().showMessage("Status Bar Message disappears while initializing first webEngineView")   
        self.lay = QVBoxLayout()       
        w = QWidget()
        w.setLayout(self.lay)
        self.setCentralWidget(w)
        self.b = QPushButton('Add webEngineView')
        self.b.setStyleSheet('background:black;color:white')
        self.b.clicked.connect(self.load)
        self.lay.addWidget(self.b)
        
        # 预加载隐藏的WebEngineView，启动内核进程
        self.preload_webview = QWebEngineView()
        self.preload_webview.setVisible(False)
        self.preload_webview.setHtml("")
        
    def load(self):
        self.webEngineView = QWebEngineView(parent=self)
        self.lay.addWidget(self.webEngineView)        
        self.webEngineView.setHtml("<style> body { background-color: black; color: white; } </style> <h1>Heading</h1> <p>Paragraph</p>") 
        time.sleep(1) # 模拟其他GUI初始化代码

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

方案2：修改初始背景色+延迟显示控件

设置QWebEngineView初始背景色匹配应用主题，同时利用loadFinished信号在页面加载完成后再显示控件，避免初始化过程中的刺眼闪烁。

import sys
import time
from PyQt6.QtWidgets import QApplication, QMainWindow, QVBoxLayout, QWidget, QPushButton
from PyQt6.QtWebEngineWidgets import QWebEngineView

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setGeometry(100, 100, 400, 400)
        self.setStyleSheet('background:gray')
        self.statusBar().showMessage("Status Bar Message disappears while initializing first webEngineView")   
        self.lay = QVBoxLayout()       
        w = QWidget()
        w.setLayout(self.lay)
        self.setCentralWidget(w)
        self.b = QPushButton('Add webEngineView')
        self.b.setStyleSheet('background:black;color:white')
        self.b.clicked.connect(self.load)
        self.lay.addWidget(self.b)          
        
    def load(self):
        self.webEngineView = QWebEngineView(parent=self)
        # 设置初始背景色为应用灰色，避免白闪
        self.webEngineView.setStyleSheet('background:gray')
        self.webEngineView.setVisible(False) # 先隐藏控件
        self.lay.addWidget(self.webEngineView)        
        # 页面加载完成后再显示控件
        self.webEngineView.loadFinished.connect(self.on_webview_loaded)
        self.webEngineView.setHtml("<style> body { background-color: black; color: white; } </style> <h1>Heading</h1> <p>Paragraph</p>") 
        time.sleep(1) # 模拟其他GUI初始化代码

    def on_webview_loaded(self, success):
        if success:
            self.webEngineView.setVisible(True)
            # 恢复页面自身背景色
            self.webEngineView.setStyleSheet('')

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

方案3：将耗时初始化移至子线程

把非GUI的耗时初始化逻辑放到QThread中执行，避免阻塞主线程导致界面刷新停滞。注意：Qt中GUI操作必须在主线程，子线程仅处理非UI逻辑，通过信号槽回调主线程执行GUI操作。

import sys
import time
from PyQt6.QtWidgets import QApplication, QMainWindow, QVBoxLayout, QWidget, QPushButton
from PyQt6.QtWebEngineWidgets import QWebEngineView
from PyQt6.QtCore import QThread, pyqtSignal

class InitThread(QThread):
    init_finished = pyqtSignal()

    def run(self):
        # 执行耗时的非GUI初始化逻辑
        time.sleep(1)
        self.init_finished.emit()

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setGeometry(100, 100, 400, 400)
        self.setStyleSheet('background:gray')
        self.statusBar().showMessage("Status Bar Message disappears while initializing first webEngineView")   
        self.lay = QVBoxLayout()       
        w = QWidget()
        w.setLayout(self.lay)
        self.setCentralWidget(w)
        self.b = QPushButton('Add webEngineView')
        self.b.setStyleSheet('background:black;color:white')
        self.b.clicked.connect(self.load)
        self.lay.addWidget(self.b)          
        
    def load(self):
        self.webEngineView = QWebEngineView(parent=self)
        self.lay.addWidget(self.webEngineView)        
        self.webEngineView.setHtml("<style> body { background-color: black; color: white; } </style> <h1>Heading</h1> <p>Paragraph</p>") 
        # 启动子线程执行初始化
        self.init_thread = InitThread()
        self.init_thread.init_finished.connect(self.on_init_finished)
        self.init_thread.start()

    def on_init_finished(self):
        # 初始化完成后的GUI操作
        self.statusBar().showMessage("Initialization finished")

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

方案选择建议 #

• 预加载内核适合需要多次使用QWebEngineView的场景，从根源解决首次启动阻塞问题。
• 修改背景色+延迟显示是快速适配深色主题的临时方案，能有效降低闪烁刺眼感。
• 子线程方案适合初始化代码确实耗时的场景，保证主线程流畅刷新界面。

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