PyQt6继承QWidget的子类不显示，继承QLabel则正常显示问题求助

我正在学习PyQt/Qt，遇到一个基础问题：想要创建一个继承自QWidget的子类，但该子类无法显示。

为排查问题，我编写了一个简单的测试子类代码：

from PyQt6.QtWidgets import QWidget, QApplication,QMainWindow, QLabel
import sys

class TestWidget(QWidget):
    pass

class TestLabel(QLabel):
    pass

app = QApplication(sys.argv)
w = QMainWindow()
w.resize(500,500)
w.setStyleSheet('background-color: white;')
w.show()

#frame = QWidget(w)     # SHOWS
frame = TestWidget(w)   # DOES NOT SHOW
#frame = TestLabel(w)   # SHOWS
frame.resize(200,200)
frame.setStyleSheet('background-color: red;')
frame.show()

app.exec()

我测试了三种场景（注释另外两种选项），预期结果是左上角出现红色矩形：

• 使用普通QWidget对象：正常显示
• 使用继承QWidget的TestWidget子类：无法显示
• 使用继承QLabel的TestLabel子类：正常显示

代码非常简单，但我无法理解原因。我的运行环境是Mac OS Ventura（Apple Silicon）系统下的Python 3.11。

问题原因与解决方法 #

这是因为QWidget的子类默认不会启用样式表背景绘制，而原生QWidget和QLabel内部已经处理了样式表的绘制逻辑：

1. 原生QWidget直接实例化时，会自动启用样式表背景支持；但自定义子类需要显式开启该属性。
2. QLabel作为内置控件，本身具备完善的绘制实现，样式表能直接生效。

两种解决方式： #

方式一：设置WA_StyledBackground属性

可以在自定义子类的初始化方法中添加属性设置：

from PyQt6.QtCore import Qt

class TestWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setAttribute(Qt.WidgetAttribute.WA_StyledBackground, True)

也可以在实例化子类后直接设置：

frame = TestWidget(w)
frame.setAttribute(Qt.WidgetAttribute.WA_StyledBackground, True)

方式二：重写paintEvent方法

如果需要更灵活的自定义绘制逻辑，可手动重写paintEvent绘制背景：

from PyQt6.QtGui import QPainter, QBrush, QColor

class TestWidget(QWidget):
    def paintEvent(self, event):
        painter = QPainter(self)
        painter.setBrush(QBrush(QColor("red")))
        painter.drawRect(self.rect())

修改后，自定义的TestWidget就能正常显示红色背景了。

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