PyQt5：外部文件创建的Widget无法应用QtStyleSheets ID选择器

你的问题核心是：QLabel的通用CSS样式正常生效，但指定了example ID的QWidget背景样式未渲染。这是因为QWidget默认不会自动绘制背景，即使通过CSS设置background-color也不会生效，而QLabel这类控件属于Qt的“样式感知”组件，默认支持背景绘制。

以下是三种可行的解决方法：

方法1：启用自动背景填充 #

在ExampleLabel的初始化方法中添加setAutoFillBackground(True)，让QWidget自动填充背景，CSS样式即可生效：

# item.py 修改后
class ExampleLabel(QWidget):
    def __init__(self):
        super().__init__()
        self.vbox = QVBoxLayout()
        self.setObjectName("example")
        self.setAutoFillBackground(True)  # 启用自动背景填充

        self.label = QLabel("Hello World")

        self.vbox.addWidget(self.label)
        self.setLayout(self.vbox)

方法2：改用QFrame代替QWidget #

QFrame是QWidget的子类，默认支持背景样式渲染，直接替换继承类即可，无需额外配置：

# item.py 修改后
class ExampleLabel(QFrame):  # 将QWidget改为QFrame
    def __init__(self):
        super().__init__()
        self.vbox = QVBoxLayout()
        self.setObjectName("example")

        self.label = QLabel("Hello World")

        self.vbox.addWidget(self.label)
        self.setLayout(self.vbox)

方法3：重写paintEvent手动绘制背景 #

如果必须使用QWidget，可以重写paintEvent方法，手动绘制背景颜色：

# item.py 修改后
from PyQt5.QtGui import QPainter
from PyQt5.QtWidgets import QWidget, QVBoxLayout, QLabel

class ExampleLabel(QWidget):
    def __init__(self):
        super().__init__()
        self.vbox = QVBoxLayout()
        self.setObjectName("example")

        self.label = QLabel("Hello World")

        self.vbox.addWidget(self.label)
        self.setLayout(self.vbox)

    def paintEvent(self, event):
        painter = QPainter(self)
        # 获取样式表中设置的背景色并绘制
        bg_color = self.palette().color(self.backgroundRole())
        painter.fillRect(self.rect(), bg_color)
        super().paintEvent(event)

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