如何在PySide6中正确使用Chromium深色模式标识(--enable-force-dark)？

设置QTWEBENGINE_CHROMIUM_FLAGS后QtWebEngine未触发全局深色模式，主要有以下几个原因及对应解决办法：

• 环境变量设置时机错误
  QtWebEngine会在模块加载阶段读取Chromium的启动参数，因此必须在导入任何PySide6相关模块之前设置环境变量。如果先导入QApplication或QWebEngineView再设置变量，参数不会被生效。

• 缺少补充配置参数
  部分版本的QtWebEngine仅靠--enable-force-dark不足以触发全局深色模式，需要搭配Blink的深色模式规则参数。推荐使用组合参数：

  --enable-force-dark --blink-settings=darkMode=4,darkModeImagePolicy=2
  

  其中：

  • darkMode=4：强制所有网站应用深色模式（对应Chromium的自动深色模式逻辑）
  • darkModeImagePolicy=2：避免图片被强制反色，保留原有显示效果（可根据需求调整）

• QtWebEngine版本过低
  旧版本的QtWebEngine（如Qt 5.14及更早）不支持--enable-force-dark参数，需升级到Qt 5.15或Qt 6.2以上版本。

修正后的示例代码 #

import os
import sys

# 必须在导入PySide6前设置环境变量
os.environ["QTWEBENGINE_CHROMIUM_FLAGS"] = "--enable-force-dark --blink-settings=darkMode=4,darkModeImagePolicy=2"

# 导入PySide6模块
from PySide6.QtWidgets import QApplication
from PySide6.QtWebEngineWidgets import QWebEngineView

app = QApplication(sys.argv)
browser = QWebEngineView()
browser.load("https://www.example.com")
browser.show()

sys.exit(app.exec())

额外注意事项 #

如果是打包后的应用（如使用PyInstaller），需在打包脚本中提前设置环境变量，避免打包工具提前加载PySide6模块导致参数失效。

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