PySide6自定义多选QComboBox无法勾选选项问题排查

以下是PySide6中转写PyQt5代码后常见的问题点及解决方法：

1. 未给模型项启用可勾选属性 #

如果你的代码没有为模型中的每个选项设置可勾选状态，复选框仅会显示但无法交互。需要确保每个项都开启checkable属性，并在flags中包含ItemIsUserCheckable：

from PySide6.QtGui import QStandardItem
from PySide6.QtCore import Qt

# 创建可勾选的项
item = QStandardItem("选项1")
item.setCheckable(True)
# 确保项具备可勾选和可交互的权限
item.setFlags(item.flags() | Qt.ItemIsUserCheckable | Qt.ItemIsEnabled)

2. 默认视图不响应复选框点击 #

QComboBox的默认QListView不会处理复选框的点击事件，需要自定义视图并重写mousePressEvent来切换复选框状态：

from PySide6.QtWidgets import QListView

class CheckableListView(QListView):
    def mousePressEvent(self, event):
        index = self.indexAt(event.pos())
        if index.isValid():
            item = self.model().itemFromIndex(index)
            if item.isCheckable():
                # 切换选中状态
                new_state = Qt.Checked if item.checkState() == Qt.Unchecked else Qt.Unchecked
                item.setCheckState(new_state)
        # 调用父类方法保证其他交互正常
        super().mousePressEvent(event)

然后将自定义视图绑定到QComboBox：

combo_box.setView(CheckableListView())

3. 自定义模型未正确处理复选框状态 #

如果使用了自定义数据模型，必须确保data()和setData()方法正确处理CheckStateRole，同时flags()方法返回包含可勾选权限的标记：

from PySide6.QtCore import QAbstractListModel, Qt

class CheckableModel(QAbstractListModel):
    def __init__(self, option_list, parent=None):
        super().__init__(parent)
        # 存储选项文本和复选状态
        self.options = [(opt, Qt.Unchecked) for opt in option_list]

    def rowCount(self, parent=None):
        return len(self.options)

    def data(self, index, role=Qt.DisplayRole):
        if not index.isValid():
            return None
        row = index.row()
        if role == Qt.DisplayRole:
            return self.options[row][0]
        elif role == Qt.CheckStateRole:
            return self.options[row][1]
        return None

    def setData(self, index, value, role=Qt.EditRole):
        if role == Qt.CheckStateRole:
            self.options[index.row()] = (self.options[index.row()][0], value)
            self.dataChanged.emit(index, index)
            return True
        return super().setData(index, value, role)

    def flags(self, index):
        return super().flags(index) | Qt.ItemIsUserCheckable | Qt.ItemIsEnabled

4. 枚举常量的版本适配问题 #

PySide6中Qt枚举常量的调用方式为Qt.XXX（如Qt.Checked），而PyQt5中可能是QtCore.Qt.Checked，如果转写时未调整常量路径，会导致状态设置无效。

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