PyQt5设置全局QSS后QListWidget选中项自定义颜色不生效问题求助

问题根因 #

你给QListWidgetItem插入了自定义QWidget作为条目内容，新增的通配符*规则会匹配所有控件，包括这两个自定义QWidget，给它们统一设置了灰色背景。自定义QWidget层级高于QListWidget的条目本身，所以下层条目选中时的背景色会被完全遮挡，导致你写的QListWidget::item:selected规则看起来失效了。

修复方案 #

你可以根据自己的业务需求选择以下任意一种方案：

• 方案1：在原有样式基础上新增一条规则，把QListWidget内部的QWidget背景设为透明即可，不会影响其他控件的全局样式配置：

self.setStyleSheet(
    '*{font-size: 15px;background-color: rgb(150, 150, 150);}'
    'QListWidget::item:selected{background: rgb(0,0,0);}'
    # 新增规则：QListWidget内部的QWidget背景透明，不遮挡条目选中色
    'QListWidget QWidget{background-color: transparent;}'
)

• 方案2：避免用通配符*设置全局背景，改为单独指定需要设置背景的控件类型，比如QWidget#Window,QPushButton{background-color: rgb(150, 150, 150);}，避免无差别匹配所有控件。
• 方案3：如果你的自定义QWidget本身需要特殊样式，可以单独给它设置objectName，用ID选择器精准指定样式，避免继承全局的灰色背景：

# 给自定义widget设置objectName
w1.setObjectName("customListItemWidget")
w2.setObjectName("customListItemWidget")
# QSS里单独指定样式
self.setStyleSheet('''
    *{font-size: 15px;background-color: rgb(150, 150, 150);}
    QListWidget::item:selected{background: rgb(0,0,0);}
    #customListItemWidget{
        background-color: transparent;
        /* 你需要的其他自定义样式 */
    }
''')

补充说明 #

如果没有插入自定义控件的场景下出现同类问题，通常是QSS优先级冲突导致，可通过提升选择器优先级的方式解决。

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