PyQt6中QWidgetItem无法调用setStyleSheet的问题咨询

核心原因 #

QLayout.itemAt()返回的是QLayoutItem（你的场景下是子类QWidgetItem），它是布局用来管理子元素的逻辑容器，只负责布局位置、大小的计算，本身不是可视化的Widget组件，所以没有setStyleSheet()方法，这就是报错的原因。

解决方案：获取实际Widget再设置样式 #

QWidgetItem是用来包裹QWidget的布局项，你可以通过QLayoutItem.widget()方法提取出里面的实际Widget，再给Widget设置样式表。

修改你代码中的关键行：

# 原错误代码
# self.box.itemAt(1).setStyleSheet('background-color:red;')

# 修改后
item = self.box.itemAt(1)
if item.widget():  # 先判断是否为Widget类型，避免布局项是间隔等非Widget的情况
    item.widget().setStyleSheet('background-color:red;')

修改后的完整代码 #

from PyQt6.QtWidgets import *
from PyQt6.QtCore import *
from PyQt6.QtGui import *
        

class main(QMainWindow):
    def __init__(self):
        super().__init__()
        self.box = QHBoxLayout()
        self.widget = QWidget()
        self.widget.setLayout(self.box)

        self.button = QPushButton('button1')
        self.button2 = QPushButton('button2')
        self.button3 = QPushButton('button3')
        self.box.addWidget(self.button)
        self.box.addWidget(self.button2)
        self.box.addWidget(self.button3)

        # 修正后的样式设置代码
        item = self.box.itemAt(1)
        if item.widget():
            item.widget().setStyleSheet('background-color:red;')

        self.setCentralWidget(self.widget)
        self.show()
    

app = QApplication([])
m = main()
m.show()
app.exec()

补充说明 #

• 布局中除了QWidgetItem，还可能有QSpacerItem（间隔项）、QLayoutItem（嵌套布局）等，这些项调用widget()会返回None，所以加个判断能避免运行时错误。
• 不存在直接给QWidgetItem设置样式的方法，因为它不参与界面渲染，样式必须设置到实际的可视化Widget上。

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