PyQt5如何堆叠控件忽略重叠 解决鼠标悬浮背景被遮挡问题

问题根因 #

你当前的问题是复选框的垂直布局未设置控件间距，上下相邻的QCheckBox控件区域重叠，层级靠下的控件会遮挡上方控件的悬浮背景。

解决方案 #

方案1：调整布局与样式，完全避免控件重叠（推荐） #

不需要改动控件逻辑，仅修改2处配置即可解决：

1. 给复选框的垂直布局设置合适的间距，避免控件区域重叠，在初始化self.checkbox_layout后添加一行代码：

self.checkbox_layout.setSpacing(8)

2. 微调QCheckBox的QSS样式，将上下内边距调整到合适范围，避免元素高度过大挤压间距，把样式中padding : 15px;改为上下、左右分开设置，可按需调整数值：

QCheckBox
{
    background-color : rgb(25,34,52);
    border-radius : 5px;
    spacing : 10px;
    padding : 12px 15px; /* 上下12px，左右15px */
    min-height : 15px;
}

该方案可以完全避免控件重叠，是最稳定的实现方式。

方案2：保留紧凑间距，悬浮时主动提升控件层级 #

如果需要保留极小的控件间距实现紧凑效果，可以自定义QCheckBox子类，在鼠标进入时将当前控件提到层级最上方，避免被下方控件遮挡：

1. 先添加自定义复选框类：

class HoverCheckBox(QCheckBox):
    def enterEvent(self, event):
        self.raise_() # 将当前控件提升到最上层
        super().enterEvent(event)

2. 将原来创建QCheckBox的代码替换为HoverCheckBox即可：

self.checkbox1 = HoverCheckBox('checkbox1')

额外修复提示 #

你的代码中重复定义了self.checkbox3，会导致第三个复选框被覆盖无法正常显示，建议修改为self.checkbox4避免变量冲突。

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