PyQt6 QListView内部拖拽异常：拖拽至项目上元素消失求助

设置自定义CustomListModel的QListView，将dragDropMode设为InternalMove后，拖拽元素到其他项目上方（而非项目之间）时，元素会直接消失。尝试过降级PyQt5、升级PyQt6，问题均未解决。目前临时解决方法是实现自定义QListView，判断若拖拽到项目上则不将事件传递给父类。

相关初始化代码：

model = CustomListModel(["Item 1", "Item 2", "Item 3", "Item 4", "Item 5"])
self.list_view.setModel(model)
self.list_view.setDragDropMode(QListView.DragDropMode.InternalMove)

问题根源 #

默认InternalMove模式下，拖拽到项目上方时QListView会触发覆盖替换逻辑，但如果自定义模型未正确实现拖放相关方法，会导致数据丢失，表现为元素消失。

正确解决方法 #

无需自定义QListView，完善CustomListModel的拖放方法即可解决问题：

关键实现步骤 #

自定义模型需继承QAbstractListModel，并正确实现以下核心方法：

• flags()：返回支持拖拽、拖放、选中、启用的标识
• supportedDropActions()：指定仅支持移动操作
• dropMimeData()：处理内部移动逻辑，避免覆盖原有项

完整CustomListModel示例 #

from PyQt5.QtCore import QAbstractListModel, Qt, QMimeData

class CustomListModel(QAbstractListModel):
    def __init__(self, data=None, parent=None):
        super().__init__(parent)
        self._data = data or []

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

    def data(self, index, role=Qt.DisplayRole):
        if not index.isValid() or role != Qt.DisplayRole:
            return None
        return self._data[index.row()]

    def flags(self, index):
        if index.isValid():
            return Qt.ItemIsDragEnabled | Qt.ItemIsDropEnabled | Qt.ItemIsSelectable | Qt.ItemIsEnabled
        return Qt.ItemIsDropEnabled

    def supportedDropActions(self):
        return Qt.MoveAction

    def dropMimeData(self, data, action, row, column, parent):
        if action != Qt.MoveAction:
            return False
        if column > 0:
            return False
        
        # 解析拖拽的行号
        dragged_rows = self._decode_mime_data(data)
        if not dragged_rows:
            return False
        
        # 确定插入位置：parent有效则插在其上方，否则用指定row
        insert_row = parent.row() if parent.isValid() else row
        # 倒序处理拖拽行，避免索引混乱
        for dragged_row in sorted(dragged_rows, reverse=True):
            item = self._data.pop(dragged_row)
            # 若拖拽行在插入位置之前，插入位置需减1
            if dragged_row < insert_row:
                insert_row -= 1
            self._data.insert(insert_row, item)
        self.layoutChanged.emit()
        return True

    def _decode_mime_data(self, data):
        # 解析Qt默认的模型数据MIME格式，提取行号
        if not data.hasFormat('application/x-qabstractitemmodeldatalist'):
            return []
        stream = data.data('application/x-qabstractitemmodeldatalist')
        rows = []
        while stream:
            # 读取行号（4字节小端）
            row = int.from_bytes(stream[:4], byteorder='little')
            rows.append(row)
            # 跳过后续的角色数据（简化处理）
            stream = stream[4:]
            while stream:
                role = int.from_bytes(stream[:4], byteorder='little')
                length = int.from_bytes(stream[4:8], byteorder='little')
                stream = stream[8+length:]
        return rows

临时方案的局限性 #

自定义QListView拦截事件的方法只是绕过了错误逻辑，但会丢失“拖拽到项目上方插入”的正常功能。完善模型拖放方法才是治本之策，既能解决元素消失问题，又能保留完整的拖放交互逻辑。

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