QListWidgetItem复选框点击异常：绑定ItemClicked后无法点击复选框

绑定itemClicked信号到自定义槽函数后，点击复选框时该信号也会被触发。此时Qt内部的复选框点击逻辑会先切换一次状态，紧接着你的槽函数又切换了一次，两次操作相互抵消，最终状态和点击前一致，导致看起来复选框点击无响应。另外，你的Item类注释掉了setFlags代码，未设置Qt.ItemIsUserCheckable标志，这会导致Qt默认的复选框点击切换功能失效，也是问题的诱因之一。

步骤1：修复Item的标志设置 #

首先确保Item类设置正确的标志，让item支持用户勾选：

class Item(QListWidgetItem):
    def __init__(self):
        super().__init__()
        # 启用用户可勾选、可选择、可用标志
        self.setFlags(Qt.ItemFlag.ItemIsUserCheckable | Qt.ItemFlag.ItemIsSelectable | Qt.ItemFlag.ItemIsEnabled)
        self.setCheckState(Qt.CheckState.Unchecked)
        self.setToolTip("double click edit")

步骤2：自定义ListWidget区分点击区域 #

重写QListWidget的mousePressEvent方法，判断点击位置是否属于复选框区域，仅在点击item非复选框区域时切换状态：

from PyQt6.QtWidgets import QListWidget, QStyleOptionViewItem, QStyle
from PyQt6.QtCore import Qt, QPoint

class CustomListWidget(QListWidget):
    def __init__(self, parent=None):
        super().__init__(parent)

    def mousePressEvent(self, event):
        item = self.itemAt(event.pos())
        if item:
            # 获取复选框的绘制区域
            opt = QStyleOptionViewItem()
            self.initStyleOption(opt, item)
            check_rect = self.style().subElementRect(QStyle.SubElement.SE_ItemViewItemCheckIndicator, opt, self)
            # 点击非复选框区域时切换状态
            if not check_rect.contains(event.pos()):
                item.setCheckState(Qt.CheckState.Unchecked if item.checkState() == Qt.CheckState.Checked else Qt.CheckState.Checked)
        # 调用父类方法保留原有功能（如选中item）
        super().mousePressEvent(event)

步骤3：替换MainWindow中的ListWidget #

在MainWindow的__init__方法中，将原有的QListWidget替换为自定义的CustomListWidget：

self.list_widget = CustomListWidget()

这样修改后，点击item的任意区域（包括复选框）都能正常切换复选框状态：点击复选框时由Qt原生逻辑处理，点击item其他区域时由自定义逻辑处理，两者互不干扰。

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