Qt列表控件开启拖拽排序需四步：setDragEnabled(true)、setAcceptDrops(true)、setDropIndicatorShown(true)、setDragDropMode(QAbstractItemView::InternalMove)；QListWidget推荐SingleSelection模式，QListView+QStandardItemModel必须重写dropEvent并手动处理插入位置，同时注意屏蔽模型信号与代理模型干扰。
Qt列表控件开启拖拽支持的必要配置
默认情况下，QListWidget 和 QListView 都不启用拖拽排序，必须显式设置才能生效。光调用 setDragEnabled(true) 不够，还容易漏掉关键属性。
-
setDragEnabled(true)：允许拖动项 -
setAcceptDrops(true)：允许接收外部或自身拖入的项（排序必须设） -
setDropIndicatorShown(true)：显示拖拽插入位置指示线（强烈建议开启，否则用户无法预判落点） -
setDragDropMode(QAbstractItemView::InternalMove)：这是排序的核心——仅允许内部移动，不接受外部数据，也不触发复制/链接等行为
如果只设了前两项而没设 setDragDropMode，拖拽时会静默失败，控制台无报错，但项完全不动。
QListWidget 拖拽排序无需重写事件，但要注意 selectionMode
QListWidget 在 InternalMove 模式下自带基础排序逻辑，前提是选中模式兼容。常见陷阱是用了 QAbstractItemView::NoSelection 或 MultiSelection —— 前者导致无法拖动，后者可能引发多选项一起移动、顺序错乱。
- 推荐设为
setSelectionMode(QAbstractItemView::SingleSelection) - 若需支持多选后整体拖拽（如批量调整位置），必须重写
dropEvent并手动处理mimeData()中的 item index 列表，不能依赖默认行为 - 默认排序逻辑按鼠标松开时的视觉插入点决定新索引，不是按原始选中顺序拼接
示例：拖动第 2 项到第 0 项上方，它会变成新列表的第 0 项；但如果中间有多个项被选中，且未定制逻辑，结果可能不符合直觉。
立即学习“C++免费学习笔记（深入）”；
QListView + QStandardItemModel 的拖拽排序必须重载 dropEvent
QListView 自身不管理数据，排序动作最终由 model 处理。QStandardItemModel 默认允许移动，但它的 dropMimeData 实现对插入位置判断较粗粒度，常导致拖到两个 item 中间时插到错误位置（比如本该插在索引 3，却插到索引 4）。
- 必须子类化
QListView并重写dropEvent - 在重写中调用
indexAt(event->pos())获取精确目标 index，再用model()->insertRow()和model()->removeRow()手动搬运数据 - 注意：拖拽源可能是多个连续或非连续行，
selectedIndexes()返回的是视图坐标，需用model()->index()转换为 model 坐标 - 务必在操作前调用
event->acceptProposedAction()，否则拖拽动画会中断
不重写 dropEvent 时，看似能动，但插入点常偏移 1 行，尤其在列表末尾或空区域拖放时表现异常。
拖拽过程中禁用模型信号避免界面闪烁或逻辑冲突
拖拽排序本质是多次 removeRow + insertRow，每次都会触发 rowsRemoved / rowsInserted 信号。如果其他组件监听这些信号并做 UI 更新（比如统计数量、刷新关联视图），可能造成闪烁、重复计算甚至崩溃。
- 在
dropEvent开始前调用model()->blockSignals(true) - 全部操作完成后调用
model()->blockSignals(false) - 更稳妥的做法是 emit 一个自定义的
itemsReordered()信号，在所有移动完成后再统一通知，而不是依赖底层 row 变更信号 - 如果 model 上层还有 proxy model（如
QSortFilterProxyModel），记得先setDynamicSortFilter(false)，否则排序可能干扰拖拽位置计算
最易忽略的是 proxy model 的动态过滤——它会让 indexAt() 返回的视图 index 与 model index 不一致，导致插入位置错位，这个坑往往要调试半天才意识到。
