如何在QML+Python跨平台应用中处理系统深色模式？

使用QML+Python开发跨平台应用，在Mac环境下遇到系统深色模式处理问题（不确定Windows是否适用）。当前通过手动设置darkMode属性切换深浅模式，希望实现自动检测系统模式并同步设置该属性，或寻求其他可行方案。

当前QML代码：

import QtCore
import QtQuick
import QtQuick.Controls
import QtQuick.Dialogs

ApplicationWindow {
    width: 640
    height: 480
    visible: true
    property bool darkMode: false
    
    Text {
        id: textField
        color: {
            switch (darkMode) {
                case true:
                    "white";
                    break;
                case false:
                    "black";
                    break;
            }
         }
    }
}

方法1：直接使用Qt内置的颜色方案检测（推荐，跨平台） #

Qt 5.14及以上版本提供了Qt.styleHints.colorScheme属性，可直接在QML中获取系统当前的颜色方案，支持Mac、Windows、Linux等平台，且能自动监听系统主题变化。

修改后的QML代码：

import QtCore
import QtQuick
import QtQuick.Controls
import QtQuick.Dialogs

ApplicationWindow {
    width: 640
    height: 480
    visible: true
    // 自动绑定系统深色模式状态，系统切换时自动更新
    property bool darkMode: Qt.styleHints.colorScheme === Qt.Dark

    Text {
        id: textField
        // 用三元表达式简化颜色判断
        color: darkMode ? "white" : "black"
    }
}

• Qt.styleHints.colorScheme有三个取值：Qt.Light、Qt.Dark、Qt.Unknown（极少数情况）
• 当系统切换深浅模式时，该属性会自动更新，绑定的darkMode和Text颜色也会同步变化

方法2：通过Python层获取系统主题状态（兼容旧版Qt） #

如果使用的Qt版本低于5.14，或需要在Python逻辑中处理主题状态，可通过Python调用系统API获取当前模式，再传递给QML。

Mac平台Python代码示例 #

import objc
from Foundation import NSUserDefaults

def get_system_dark_mode():
    defaults = NSUserDefaults.standardUserDefaults()
    # 获取系统外观设置，返回True表示深色模式
    return defaults.objectForKey_("AppleInterfaceStyle") == "Dark"

Windows平台Python代码示例 #

import winreg

def get_system_dark_mode():
    try:
        # 读取Windows深色模式注册表项
        key = winreg.OpenKey(winreg.HKEY_CURRENT_USER, r"Software\Microsoft\Windows\CurrentVersion\Themes\Personalize")
        value, _ = winreg.QueryValueEx(key, "AppsUseLightTheme")
        winreg.CloseKey(key)
        # 返回True表示深色模式（0为深色，1为浅色）
        return value == 0
    except Exception:
        # 读取失败默认返回浅色模式
        return False

Python与QML交互传递状态 #

通过PySide6/PyQt的上下文属性传递状态，再在QML中绑定：

from PySide6.QtQuick import QQuickView
from PySide6.QtCore import QUrl

view = QQuickView()
# 获取系统深色模式状态
dark_mode = get_system_dark_mode()
# 给QML上下文设置属性
view.rootContext().setContextProperty("systemDarkMode", dark_mode)
view.setSource(QUrl.fromLocalFile("main.qml"))
view.show()

QML中使用：

ApplicationWindow {
    property bool darkMode: systemDarkMode
    // ... 其余代码不变
}

注：这种方法需要额外实现系统主题变化的监听逻辑，才能实现自动同步。

方法3：使用Qt Quick Controls内置风格自动适配 #

Qt Quick Controls的Material、Universal等风格会自动跟随系统主题，无需手动设置颜色，直接使用风格提供的颜色变量即可，代码更简洁且贴合系统原生风格。

示例（Material风格）：

import QtCore
import QtQuick
import QtQuick.Controls
import QtQuick.Controls.Material

ApplicationWindow {
    width: 640
    height: 480
    visible: true
    // Material风格自动跟随系统主题
    Material.theme: Material.System

    Text {
        id: textField
        // 使用Material风格的文本颜色，自动适配深浅模式
        color: Material.body1.color
    }
}

• 除了Material.body1.color，还有Material.textColor、Material.accentColor等变量可直接使用
• Universal风格同理，设置Universal.theme: Universal.System即可

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