QListWidget实现拖拽排序需设setDragDropMode(QAbstractItemView::InternalMove)、setSelectionMode(SingleSelection)并重写dropEvent；Qt6中internalMove信号已废弃，应监听model()->rowsMoved()。
QListWidget 默认不支持拖拽排序，必须手动启用
Qt 的 QListWidget 默认禁用拖拽功能，即使设置了 setDragEnabled(true) 和 setAcceptDrops(true)，也仅支持拖入外部数据（如文件路径），**不会自动重排内部 item**。真正实现“拖拽项来改变顺序”，需要同时开启拖拽、接受、重排三类行为，并重写关键事件处理逻辑。
- 必须调用
setDragDropMode(QAbstractItemView::InternalMove)—— 这是核心开关，仅设DragOnly或DragDrop都不行 -
setDragEnabled(true)和setAcceptDrops(true)是必要但不充分条件 - 如果还设置了
setDropIndicatorShown(true)，会看到插入线提示，但不影响逻辑
为什么 setDragDropMode(InternalMove) 后仍无法排序？检查 selectionMode
常见现象：拖动 item 时光标变成禁止符号（?），松手后无反应。大概率是 selectionMode() 不匹配。Qt 要求在 InternalMove 模式下，**必须使用单选模式（SingleSelection）或扩展多选（ExtendedSelection）**，而 NoSelection 或 ContiguousSelection 会导致拖拽被拒绝。
- 推荐设为
setSelectionMode(QAbstractItemView::SingleSelection)（最稳妥） - 若需多选拖拽（如一次拖多个 item 改变相对位置），则用
ExtendedSelection，但注意 Qt 默认只允许拖拽**当前选中项集合**，且目标位置插入的是整个选中块 - 别用
ContiguousSelection—— 它要求选区连续，但拖拽过程中选区可能被临时破坏，触发校验失败
拖拽过程中 item 消失或位置错乱？重写 dropEvent 是关键
即使启用了 InternalMove，某些 Qt 版本（尤其是 5.15+ / 6.x）在跨区域拖拽或快速操作时，QListWidget 的默认 dropEvent 可能误删 item 或插入到错误索引。稳妥做法是**拦截并重写 dropEvent，手动计算插入位置并移动 item**。
- 在子类中重写：
void MyListWidget::dropEvent(QDropEvent *event) { if (event->source() == this && event->mimeData()->hasFormat("application/x-qabstractitemmodeldatalist")) { event->accept(); QPoint pos = event->pos(); int row = indexAt(pos).row(); if (row == -1) row = count(); // 拖到末尾 // 获取当前选中项（按原始顺序） auto items = selectedItems(); // 从后往前移，避免索引偏移 for (int i = items.size() - 1; i >= 0; --i) { QListWidgetItem *item = items[i]; takeItem(row(item)); if (row > row(item)) row--; // 原位置在目标前，插入点前移 insertItem(row, item); } } else { QListWidget::dropEvent(event); // 兜底给父类处理外部数据 } } - 注意：
row(item)返回的是 item 当前所在行号，必须在takeItem()前调用 - 从后往前遍历
items是为了避免多次takeItem()导致后续row(item)失效
Qt 6 中的兼容性坑：QListWidget::internalMove 信号已废弃
Qt 5.12 引入了 internalMove 信号用于监听内部移动，但在 Qt 6.0+ 中该信号已被移除。如果你的代码里有连接这个信号做后续处理（比如保存顺序），现在必须改用 itemChanged 或监听 model()->rowsMoved() —— 但后者需获取底层 QStandardItemModel 实例（QListWidget 内部使用它）。
立即学习“C++免费学习笔记（深入）”；
- Qt 6 推荐方式：
connect(model(), &QAbstractItemModel::rowsMoved, this, [=](const QModelIndex &parent, int start, int end, const QModelIndex &dest, int row) { // 注意：start/end 是原范围，row 是新起始行；parent 和 dest 通常为空 }); - 不要依赖
currentRowChanged或itemSelectionChanged判断排序完成——它们在拖拽过程中就频繁触发 - 如果项目必须兼容 Qt 5 和 Qt 6，建议封装一个
onItemsReordered()回调，在重写的dropEvent结束后手动 emit
真正的难点不在开启拖拽，而在处理多选、边界位置（拖到开头/结尾）、与键盘快捷键（如 Ctrl+Shift+↑↓）的交互一致性。这些细节不显眼，但用户一试就会暴露。
