PyQtDarkTheme中QComboBox下拉框选中项勾选标记缺失问题求助

问题描述 #

在使用PyQt6搭配PyQtDarkTheme时，QComboBox下拉框的当前选中项无法正常显示勾选标记（或因对比度极低几乎不可见），但未应用主题时该功能正常，属于主题样式覆盖导致的UI问题。

未使用PyQtDarkTheme（勾选标记可见）	使用PyQtDarkTheme（勾选标记缺失）

最小可复现代码 #

# pip install pyqt6 qdarktheme
import sys
import qdarktheme
from PyQt6.QtWidgets import QApplication, QWidget, QVBoxLayout, QComboBox

class Demo(QWidget):
    def __init__(self):
        super().__init__()

        combo = QComboBox()
        combo.addItems(["First option", "Second option", "Third option"])

        layout = QVBoxLayout(self)
        layout.addWidget(combo)

        self.setWindowTitle("PyQtDarkTheme – invisible check‑mark")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    app.setStyleSheet(qdarktheme.load_stylesheet("auto"))  # 应用主题
    w = Demo()
    w.resize(250, 80)
    w.show()
    sys.exit(app.exec())

环境信息 #

• Python 3.11
• PyQt6 6.8
• PyQtDarkTheme 2.1
• macOS 15

解决方案 #

方法1：自定义样式表强制提升勾选标记对比度 #

通过追加自定义样式表，覆盖PyQtDarkTheme中对QComboBox下拉项的样式设置，确保勾选标记清晰可见：

# pip install pyqt6 qdarktheme
import sys
import qdarktheme
from PyQt6.QtWidgets import QApplication, QWidget, QVBoxLayout, QComboBox

class Demo(QWidget):
    def __init__(self):
        super().__init__()

        combo = QComboBox()
        combo.addItems(["First option", "Second option", "Third option"])

        layout = QVBoxLayout(self)
        layout.addWidget(combo)

        self.setWindowTitle("PyQtDarkTheme – visible check‑mark")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    # 加载主题样式并追加自定义样式
    theme_style = qdarktheme.load_stylesheet("auto")
    custom_style = """
    /* 调整下拉选中项的背景色，增强区分度 */
    QComboBox QAbstractItemView::item:selected {
        background-color: #3a5f9e;
    }
    /* 设置勾选标记的颜色与边框，确保深色主题下可见 */
    QComboBox QAbstractItemView::indicator:checked {
        color: #ffffff;
        border: 1px solid #ffffff;
    }
    """
    app.setStyleSheet(theme_style + custom_style)
    w = Demo()
    w.resize(250, 80)
    w.show()
    sys.exit(app.exec())

你可以根据实际需求调整颜色值，比如把#3a5f9e换成更贴合你主题的背景色，#ffffff可以换成其他高对比度颜色。

方法2：升级PyQtDarkTheme到最新版本 #

该问题可能是旧版本的已知bug，优先尝试升级到最新版本：

pip install --upgrade pyqt-darktheme

升级后重新运行代码，检查勾选标记是否恢复正常。

方法3：切换主题模式或变体 #

如果升级无效，可以尝试更换主题模式，比如强制使用深色/浅色主题：

# 强制使用深色主题
app.setStyleSheet(qdarktheme.load_stylesheet("dark"))
# 或强制使用浅色主题
app.setStyleSheet(qdarktheme.load_stylesheet("light"))

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