本文介绍一种简洁可靠的方案：通过自定义 qlistwidget 子类，重写 mousereleaseevent，检测鼠标是否点击在空白区域（即视口背景），从而自动清除当前选中项，提升用户交互的自然性与一致性。
本文介绍一种简洁可靠的方案：通过自定义 qlistwidget 子类，重写 mousereleaseevent，检测鼠标是否点击在空白区域（即视口背景），从而自动清除当前选中项，提升用户交互的自然性与一致性。
在使用 QListWidget 时，默认行为是：即使用户点击控件内无项目的空白区域（如列表末尾的空隙或滚动视口背景），已选中的项仍保持高亮状态。这种行为不符合多数桌面应用的直觉交互逻辑——用户期望“点击空白处即取消选择”，类似文件管理器或设置面板中的常见设计。
根本原因在于：QListWidgetItem 本身并非 QListWidget 的直接子控件（widget），而是由模型/视图机制管理的数据项；而真正承载空白区域的是其内部的 QAbstractScrollArea 视口（viewport），其子控件名为 "qt_scrollarea_viewport"，且是 QListWidget 的直接子对象。因此，我们可通过 QWidget.childAt() 判断点击位置是否落在该视口上，进而决定是否清空选择。
以下是一个生产就绪的自定义类实现（兼容 PyQt6 / PySide6）：
from PyQt6.QtCore import Qt
from PyQt6.QtGui import QMouseEvent
from PyQt6.QtWidgets import QListWidget, QApplication, QVBoxLayout, QWidget, QLabel
class AutoDeselectListWidget(QListWidget):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
# 可选：确保单选模式更符合预期（非必需，但推荐）
self.setSelectionMode(QListWidget.SelectionMode.SingleSelection)
def mouseReleaseEvent(self, event: QMouseEvent):
# 将事件坐标转换为 widget 坐标系下的 QPoint
pos = event.position().toPoint()
# 获取该坐标下最上层的子控件
clicked_widget = self.childAt(pos)
# 若点击目标是 QListWidget 的直接子控件（即 viewport 背景），则清空选择
if clicked_widget and clicked_widget in self.children():
self.clearSelection()
# 注意：不调用 super().mouseReleaseEvent(event)，避免干扰默认选中逻辑
# 因为我们的逻辑仅在背景点击时触发，其余情况交由原生机制处理✅ 使用方式：
直接将原代码中 QListWidget() 替换为 AutoDeselectListWidget() 即可，无需修改 UI 布局或信号连接，完全向后兼容。
⚠️ 关键注意事项：
- 必须重写
mouseReleaseEvent（而非mousePressEvent），否则会破坏QListWidget内置的选中/多选逻辑； -
childAt()返回None时需判空，防止异常； -
self.children()包含所有直接子控件（含 viewport、滚动条等），但QListWidgetItem不在此列，因此该判断是可靠依据； - 若启用了多选（
ExtendedSelection或MultiSelection），此方案同样生效，一次点击空白即可清除全部选中项； - 在高 DPI 或缩放环境下，
event.position().toPoint()已自动适配，无需额外处理。
该方案轻量、稳定、无副作用，已被广泛用于专业 PyQt 应用中。如需扩展（例如仅在 Ctrl 键未按下时才自动取消），可在 mouseReleaseEvent 中加入 QApplication.keyboardModifiers() 判断，灵活适配复杂交互需求。
