Python 3.11升级后PyQt应用适配深色主题问题及解决需求

一、强制启用浅色主题 #

针对你的需求（面向厌恶深色主题的用户，需永久固定浅色），可以通过设置Qt的调色板来强制应用使用浅色主题，避免跟随系统深色模式，且不会出现样式表导致的显示瑕疵。修改你的main函数如下：

import sys
from PyQt5 import QtWidgets, QtCore

def main():
    app = QtWidgets.QApplication(sys.argv)
    # 设置Windows原生样式
    app.setStyle('Windows')
    # 获取Windows样式的浅色默认调色板并应用
    light_palette = QtWidgets.QStyleFactory.create('Windows').standardPalette()
    app.setPalette(light_palette)
    
    window = MainWindow()
    window.show()
    app.exec()

原理：通过调用QStyleFactory获取Windows样式的标准浅色调色板，直接替换应用的全局调色板，完全规避系统主题的影响，同时保留控件的原生样式，不会出现样式表导致的布局或显示问题。

二、添加明暗主题切换功能 #

如果需要支持用户手动切换主题，可以通过动态切换调色板实现，同样避免使用样式表带来的瑕疵。示例代码如下：

1. 主窗口类中添加切换逻辑 #

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        self.init_ui()
        self.is_dark_mode = False
        # 保存初始浅色调色板
        self.light_palette = QtWidgets.QApplication.instance().palette()
        # 预定义深色调色板
        self.dark_palette = self._create_dark_palette()

    def init_ui(self):
        # 添加主题切换按钮
        toggle_btn = QtWidgets.QPushButton("切换深色主题")
        toggle_btn.clicked.connect(self.toggle_theme)
        self.setCentralWidget(toggle_btn)

    def _create_dark_palette(self):
        """创建适配Windows样式的深色调色板"""
        palette = QtWidgets.QStyleFactory.create('Windows').standardPalette()
        # 调整关键颜色以适配深色模式
        palette.setColor(QtWidgets.QPalette.Window, QtCore.Qt.darkGray)
        palette.setColor(QtWidgets.QPalette.WindowText, QtCore.Qt.white)
        palette.setColor(QtWidgets.QPalette.Base, QtCore.Qt.black)
        palette.setColor(QtWidgets.QPalette.AlternateBase, QtCore.Qt.darkGray)
        palette.setColor(QtWidgets.QPalette.Text, QtCore.Qt.white)
        palette.setColor(QtWidgets.QPalette.Button, QtCore.Qt.darkGray)
        palette.setColor(QtWidgets.QPalette.ButtonText, QtCore.Qt.white)
        return palette

    def toggle_theme(self):
        """切换明暗主题"""
        app = QtWidgets.QApplication.instance()
        btn = self.centralWidget()
        if self.is_dark_mode:
            app.setPalette(self.light_palette)
            btn.setText("切换深色主题")
        else:
            app.setPalette(self.dark_palette)
            btn.setText("切换浅色主题")
        self.is_dark_mode = not self.is_dark_mode

2. 原main函数无需额外修改 #

保持你原有的main函数结构即可，初始化应用后会自动使用浅色调色板，用户可通过按钮切换。

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