Qt拖放需QDrag、QMimeData与目标事件协同：源端在mouseMoveEvent超阈值后调exec()，目标端须setAcceptDrops(true)并在dragEnterEvent中acceptProposedAction()，数据用QMimeData按类型规范填充。
Qt 实现拖放操作不是靠“加一个属性就自动能拖”，而是由拖源（QDrag）、数据载体（QMimeData）和目标事件（dragEnterEvent、dropEvent）三者协同完成的。漏掉任一环节，都会出现“鼠标按下去没反应”“拖进来了但 dropEvent 不触发”“光标变禁用图标”等问题。
怎么让控件变成可拖动的源（QDrag::exec() 的正确调用时机）
拖动必须由用户主动发起，不能在构造函数或初始化时直接调用 exec() —— 它是阻塞调用，会卡死事件循环。典型做法是在鼠标按下并移动一定距离后触发：
- 重写
mousePressEvent，记录起始位置（如m_pressPos = event->pos()） - 重写
mouseMoveEvent，判断位移是否超过阈值（如(event->pos() - m_pressPos).manhattanLength() > 5） - 满足条件时创建
QDrag实例，设置QMimeData，再调用exec() - 注意：
exec()返回值是Qt::DropAction，可用于判断用户最终是复制、移动还是取消了拖放
常见错误：在 mousePressEvent 里直接 exec()，导致鼠标刚按下就卡住；或未检查位移就拖，造成误触发。
为什么 dropEvent 不被调用（setAcceptDrops(true) 和事件接受链）
目标控件必须显式开启接收能力，并且在每个关键事件中“接受”它，否则 Qt 会中途终止整个拖放流程：
- 必须调用
setAcceptDrops(true)，否则连dragEnterEvent都不会发 -
dragEnterEvent中必须调用event->acceptProposedAction()或event->accept()，否则后续dragMoveEvent和dropEvent全部被屏蔽 -
dragMoveEvent虽然可选，但如果没实现，某些平台（如 macOS）可能拒绝进入dropEvent；建议至少调用event->accept() - 所有事件处理函数里避免调用
event->ignore()，那等于告诉 Qt “我不处理这个”，整个链就断了
典型现象：拖进去光标变圆圈带斜杠，松手毫无反应——八成是 dragEnterEvent 没 accept。
拖文件路径、文本、自定义数据，QMimeData 怎么填才不丢
QMimeData 是数据容器，不同 MIME 类型对应不同取值方式，填错会导致目标端读不到内容：
- 拖文件：用
setText("file:///path/to/file")是错的；应使用setUrls({QUrl::fromLocalFile("/path")})，目标端用urls()读取 - 拖纯文本：用
setText("hello")，目标端用text()；别用setData("text/plain", ...)手动编码，容易乱码 - 拖自定义结构体或对象：必须注册自定义 MIME 类型（如
"application/x-myitem"），用setData()写入序列化 QByteArray，目标端用data()读出后反序列化 - 多个类型可共存：比如同时 setUrls() 和 setText()，目标端根据自身支持能力选择读哪个
容易踩的坑：用 setData("text/plain", ...) 填文本却不设编码，Windows 上中文变问号；或拖文件只填 setText()，结果 urls().isEmpty() 为 true。
无边框窗口整体拖动 vs 控件内局部拖放，别混用同一套逻辑
这是两个完全不同的机制，代码复用会引发坐标混乱：
- 无边框窗体拖动：靠
mouseMoveEvent+move()移动整个窗口，不涉及QDrag、QMimeData，也不发任何拖放事件 - 控件间拖放：必须走
QDrag::exec()流程，依赖 Qt 的事件分发系统，move()在这里毫无作用 - 混用后果：比如在标题栏
mouseMoveEvent里误调exec()，会导致窗口瞬间“卡住+无法响应”，因为exec()抢走了鼠标控制权 - 若需“标题栏拖动窗体 + 内部列表项拖放数据”，必须严格分离：标题栏只做
move()；列表项单独监听自己的鼠标事件并启动QDrag
最常被忽略的一点：QDrag 启动后，鼠标光标、拖动图标、释放反馈全由 Qt 自动管理，你不需要、也不应该手动改 cursor 或画拖拽预览图——除非你重写了 QDrag 的 start() 或用了 setPixmap()。
