本文介绍一种简洁可靠的方案：通过自定义 qlistwidget 子类，重写 mousereleaseevent，利用 childat() 判断点击位置是否位于空白背景区，并自动调用 clearselection() 实现自然的反选行为。
本文介绍一种简洁可靠的方案：通过自定义 qlistwidget 子类，重写 mousereleaseevent，利用 childat() 判断点击位置是否位于空白背景区，并自动调用 clearselection() 实现自然的反选行为。
在使用 QListWidget 时，一个常见但易被忽视的交互缺陷是：用户点击列表项后，即使随后点击列表空白区域（即项与项之间的空隙、或滚动条上方/下方的可视区域），当前选中项仍保持高亮——这违背了多数桌面应用的直觉体验（如文件管理器、设置面板等）。PyQt 默认不会将空白区点击视为“取消选择”操作，需开发者主动干预。
核心思路是：区分点击目标是列表项（QListWidgetItem）还是背景容器。值得注意的是，QListWidget 的可视空白区域实际由其内部子控件 qt_scrollarea_viewport 承载，该控件是 QListWidget 的直接子对象（可通过 children() 获取），而真正的 QListWidgetItem 则需通过 item() 方法访问，并非直接子控件。因此，我们可借助 QWidget.childAt() 方法获取鼠标释放点位上层的最顶层控件，并判断其是否属于 QListWidget 的直接子控件集合——若是，则说明点击发生在空白背景区，应清除选中状态。
以下为完整可运行的解决方案（兼容 PyQt6，稍作调整亦适用于 PyQt5）：
from PyQt6.QtCore import Qt
from PyQt6.QtGui import QMouseEvent
from PyQt6.QtWidgets import QApplication, QListWidget, QListWidgetItem, QVBoxLayout, QWidget
class CustomListWidget(QListWidget):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
# 可选：设置单选模式以强化语义
self.setSelectionMode(QListWidget.SelectionMode.SingleSelection)
def mouseReleaseEvent(self, event: QMouseEvent):
if event.button() == Qt.MouseButton.LeftButton:
# 将事件坐标转换为 widget 坐标系下的 QPoint
point = event.position().toPoint()
# 获取该坐标处最上层的子控件
clicked_child = self.childAt(point)
# 若点击目标是 QListWidget 的直接子控件（即 viewport 背景），则清空选中
if clicked_child and clicked_child in self.children():
self.clearSelection()
# 必须调用父类方法，确保默认选择逻辑（如点击 item）正常工作
super().mouseReleaseEvent(event)
使用方式极为简单，可作为完全兼容的替代组件：
app = QApplication([])
window = QWidget()
layout = QVBoxLayout(window)
list_widget = CustomListWidget()
for i in range(5):
item = QListWidgetItem(f"Item {i+1}")
list_widget.addItem(item)
layout.addWidget(list_widget)
window.show()
app.exec()
⚠️ 关键注意事项：
- 必须重写
mouseReleaseEvent而非mousePressEvent：前者在 Qt 选择机制执行完毕后触发，不影响原有选中逻辑；后者会提前拦截，导致点击 item 时无法选中。 -
childAt()返回None时需判空，避免异常（例如鼠标快速移出窗口时）。 -
super().mouseReleaseEvent(event)不可省略，否则 item 点击将失效。 - 该方案对多选模式（
ExtendedSelection/MultiSelection）同样有效，clearSelection()会统一清除所有选中项。
通过此方案，QListWidget 的交互行为将更符合用户预期：点击项即选中，点击空白即取消——无需额外按钮或快捷键，真正实现“所见即所得”的专业级 UI 体验。
