如何让QListView的背景色与窗口颜色保持一致

我完全懂你的需求——就是想让QListView本身彻底“隐身”，和窗口背景完全融为一体，等之后加列表项时再单独给项做样式，还尽量不想用样式表对吧？你已经尝试了去掉边框、设置NoRole作为背景角色，但没达到预期，我来帮你搞定这个问题。

问题出在哪？ #

你设置了self.setBackgroundRole(QPalette.ColorRole.NoRole)，但QListView的**视口（viewport）**才是实际绘制列表内容的核心区域，它默认会自动填充背景，仅仅设置QListView本身的背景角色并不会影响到视口的行为，所以你依然能看到和窗口背景不一致的区域。

解决方法 #

只需要在自定义ListView的初始化里，给视口加一行设置就行，下面是修改后的完整代码：

from PyQt6.QtGui import QPalette
from PyQt6.QtWidgets import QFrame, QListView, QWidget

class ListView(QListView):
    ''' Custom list view widget. '''

    def __init__(self, parent: QWidget | None = None):
        '''
        Construct a list view.
        @param parent - parent widget
        '''
        super().__init__(parent)
        self.setFrameShape(QFrame.Shape.NoFrame)
        self.setBackgroundRole(QPalette.ColorRole.NoRole)
        # 关键：关闭视口的自动背景填充，让窗口背景直接透出来
        self.viewport().setAutoFillBackground(False)
        # 也可以用下面这行替代上面的代码，让视口直接使用窗口的背景色
        # self.viewport().setBackgroundRole(QPalette.ColorRole.Window)
    # end constructor
# end ListView

为什么这样有效？ #

• setAutoFillBackground(False)：让视口不再主动填充自身背景，这样就会直接透出下方的窗口背景，完美实现“控件隐身”的效果，不管你切换亮色还是暗色主题，都会和窗口颜色完全匹配。
• 如果你选self.viewport().setBackgroundRole(QPalette.ColorRole.Window)，则是让视口直接使用调色板里的Window角色颜色（也就是窗口背景色），同样能达到和窗口一致的效果。

测试效果 #

把这段修改后的ListView类替换到你的测试代码里，运行后切换亮色/暗色主题，你会发现ListView完全和窗口背景融为一体，看不到任何控件的痕迹。等后续添加列表项时，你就可以通过自定义委托（QStyledItemDelegate）来单独给项设置样式，完全不会受控件本身的背景影响。

备注：内容来源于stack exchange，提问作者steveo225