如何在QT 5.12的PySide2/Python应用中启用原生MacOS Mojave深色主题

嘿，我正好折腾过PySide2启用系统原生深色主题的问题，尤其是在MacOS Mojave上，还踩过Python2.7.10的坑，给你梳理下完整的解决方案，顺便覆盖Windows和Linux的适配～

一、核心启用逻辑 #

QT从5.12开始正式支持跟随系统的原生深色模式，PySide2作为QT的Python绑定，自然也能用上。这里有两种靠谱的启用方式：

1. 设置环境变量（快速上手） #

在脚本最开头就设置QT相关的环境变量，让应用启动时就优先使用系统原生主题：

import os
import sys
from PySide2 import QtWidgets

# 全局启用QT原生风格
os.environ['QT_QUICK_CONTROLS_STYLE'] = 'Native'
os.environ['QT_AUTO_SCREEN_SCALE_FACTOR'] = '1'

# MacOS专属：强制启用层渲染，确保深色主题生效
if sys.platform == 'darwin':
    os.environ['QT_MAC_WANTS_LAYER'] = '1'

# 初始化应用和UI
app = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QMainWindow()
window.show()
sys.exit(app.exec_())

不过你提到Python2.7.10直接运行时这个方法无效？大概率是环境变量加载时机的问题，或者PySide2版本适配的锅，下面给你更稳定的API调用方式。

2. 直接调用QT API设置（更可靠） #

绕过环境变量，直接通过QT的QApplication方法来配置风格和调色板，适配性更强：

import sys
from PySide2 import QtWidgets, QtCore

app = QtWidgets.QApplication(sys.argv)

# 设置应用使用跨平台的Fusion风格（也可以尝试'Native'，不同系统表现略有差异）
app.setStyle(QtWidgets.QStyleFactory.create('Fusion'))

# MacOS Mojave及以上：手动跟随系统深色/浅色模式
if sys.platform == 'darwin':
    # 需要用pyobjc读取系统外观设置，先装依赖：pip install pyobjc==5.3（Python2.7适配版本）
    from Foundation import NSUserDefaults
    defaults = NSUserDefaults.standardUserDefaults()
    system_appearance = defaults.stringForKey_("AppleInterfaceStyle")
    
    if system_appearance == "Dark":
        # 自定义深色调色板，覆盖默认样式
        dark_palette = app.palette()
        # 窗口背景
        dark_palette.setColor(QtWidgets.QPalette.Window, QtCore.QColor(53, 53, 53))
        # 窗口文本
        dark_palette.setColor(QtWidgets.QPalette.WindowText, QtCore.QColor(255, 255, 255))
        # 按钮背景和文本
        dark_palette.setColor(QtWidgets.QPalette.Button, QtCore.QColor(53, 53, 53))
        dark_palette.setColor(QtWidgets.QPalette.ButtonText, QtCore.QColor(255, 255, 255))
        # 文本框背景和文本
        dark_palette.setColor(QtWidgets.QPalette.Base, QtCore.QColor(35, 35, 35))
        dark_palette.setColor(QtWidgets.QPalette.Text, QtCore.QColor(255, 255, 255))
        
        app.setPalette(dark_palette)

# 启动你的UI
window = QtWidgets.QMainWindow()
window.show()
sys.exit(app.exec_())

敲黑板：MacOS下必须安装pyobjc才能读取系统的外观设置，Python2.7要指定兼容版本，不然会报错。

二、解决Python2.7.10直接运行失效的问题 #

你说PyInstaller打包后可行但直接运行不行？我之前也遇到过，原因可能是这两个：

1. 环境变量加载时机不对
   试试不在脚本里设置环境变量，而是在终端运行脚本前先手动导出：

   # MacOS/Linux终端
   export QT_QUICK_CONTROLS_STYLE=Native
   export QT_MAC_WANTS_LAYER=1
   python your_script.py
   
   # Windows命令提示符
   set QT_QUICK_CONTROLS_STYLE=Native
   python your_script.py
   

2. PySide2版本太低
   确保你装的PySide2是支持QT5.12+的版本，Python2.7下最高支持到5.15.2，用这个命令升级：

   pip install PySide2==5.15.2
   

三、Windows和Linux的适配 #

• Windows：Windows 10及以上的深色模式，只要设置QT_QUICK_CONTROLS_STYLE=Native或者用app.setStyle('Fusion')，QT会自动识别系统主题并适配。
• Linux：主流桌面环境（GNOME、KDE等）的深色模式，同样用上面的方法即可。部分桌面环境可能需要额外安装QT的原生主题包，比如GNOME下的qt5-gtk-platformtheme，装完重启脚本就生效了。

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