QListWidget InternalMove模式拖拽项到自身后方控件消失问题

核心原因 #

这是Qt QListWidget 开启InternalMove拖拽模式时的固有索引计算逻辑缺陷：

• 拖拽项到自身前方紧邻位置（比如B拖到A和B之间）时，Qt内部会判定该移动为无效操作，直接拦截，不会触发项的删除-插入流程，因此无异常。
• 拖拽项到自身后方紧邻位置（比如B拖到B和C之间）时，Qt会误判该位置为有效移动目标，触发标准移动流程：先删除原位置的拖拽项，再在计算出的目标索引位置插入新项。但删除原项后列表整体索引前移，预先计算的目标索引会出现偏移，最终插入的是未绑定自定义QCheckBox控件的空列表项，就会出现原控件消失、仅残留可拖拽空白行的异常。

复现逻辑验证 #

以初始列表项顺序A(索引0)、B(索引1)、C(索引2)为例：

1. 拖拽B项到B、C之间的位置时，Qt预先计算的目标插入索引为2
2. 流程执行第一步：删除原索引1位置的B项，此时列表变为A(索引0)、C(索引1)，原计算的目标索引2已经超出当前列表的有效索引范围
3. 流程执行第二步：在偏移后的错误索引位置插入新项，该新项未绑定原有QCheckBox控件，最终呈现为空白可拖拽行

参考异常截图 #

• 初始界面状态：
• 项消失异常状态：
• 残留空白行可拖拽状态：

修复方案 #

通过重写QListWidget的dropEvent方法，在执行默认拖拽逻辑前前置校验拦截无效移动即可，逻辑参考（以Python Qt绑定为例，C++可直接复用逻辑）：

def dropEvent(self, event):
    # 获取当前被拖拽的项及所在行
    drag_row = self.row(self.currentItem())
    # 计算当前放置位置对应的目标行
    drop_row = self.indexAt(event.position().toPoint()).row()
    # 拖拽到自身位置、自身后方紧邻位置均属于无效移动，直接拦截
    if drop_row in (drag_row, drag_row + 1):
        event.ignore()
        return
    # 其余场景执行默认拖拽逻辑
    super().dropEvent(event)

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