Qt无边框窗口默认无法拖动是因为setWindowFlags(Qt::FramelessWindowHint)移除了系统拖拽逻辑，需手动重写mousePressEvent、mouseMoveEvent和mouseReleaseEvent，并用frameGeometry().topLeft()与globalPos()正确计算偏移量。
Qt无边框窗口为什么拖不动
默认情况下，setWindowFlags(Qt::FramelessWindowHint) 会移除系统级边框和标题栏，同时也让窗口失去系统提供的拖拽逻辑。鼠标按下去没反应，不是代码没生效，而是 OS 根本没把这次点击识别为“移动窗口操作”。你得自己接管 mousePressEvent、mouseMoveEvent 和 mouseReleaseEvent，模拟系统行为。
怎么用 mouseMoveEvent 实现拖拽
关键不是“监听鼠标移动”，而是要区分“是否处于拖拽状态”——必须先在 mousePressEvent 中记录起始位置和按下状态，在 mouseMoveEvent 中只对已按下且有偏移的事件响应。否则一进窗口就乱飘。
- 在类中声明两个成员变量：
QPoint m_dragPosition（记录鼠标按下时相对于窗口左上角的偏移）、bool m_isDragging = false -
mousePressEvent中：仅当event->button() == Qt::LeftButton时设置m_isDragging = true，并计算m_dragPosition = event->globalPos() - frameGeometry().topLeft() -
mouseMoveEvent中：只处理m_isDragging为 true 的情况，调用move(event->globalPos() - m_dragPosition) -
mouseReleaseEvent中：重置m_isDragging = false
为什么 move() 有时跳一下或偏移不准
常见原因是 m_dragPosition 计算用了 pos() 或 geometry().topLeft()，它们返回的是窗口客户区坐标，不包含窗口边框（哪怕你看不见）。必须用 frameGeometry().topLeft() 或 geometry().topLeft()（后者在无边框下等价）配合 globalPos() 才能对齐。
- 错误写法：
m_dragPosition = event->pos()→ 坐标系错，拖拽时窗口会突然向左上跳 - 正确写法：
m_dragPosition = event->globalPos() - frameGeometry().topLeft() - 如果窗口启用了
setWindowOpacity()或设置了Qt::WA_TranslucentBackground，确保paintEvent没意外截断鼠标事件（比如透明区域没响应），必要时重写hitTestCustom()或用setAttribute(Qt::WA_TransparentForMouseEvents, false)
macOS 上拖拽失效的特殊处理
macOS 对无边框窗口的拖拽支持更敏感，仅靠重写鼠标事件可能仍无法拖动（尤其启用 Qt::Tool 或 Qt::SplashScreen 标志时）。必须额外设置可拖拽区域：
立即学习“C++免费学习笔记（深入）”；
- 在
paintEvent绘制的标题栏区域（比如顶部 30px 高的矩形），调用setMask(QRegion(rect))是无效的；应改用setWindowFlag(Qt::FramelessWindowHint, true)后，再调用setWindowFlag(Qt::WindowTransparentForInput, false) - 更稳妥的做法：在顶部区域安装事件过滤器，或直接使用
QMainWindow::setUnifiedTitleAndToolBarOnMac(true)（如果适用） - 验证是否生效：拖拽时打印
QCursor::pos()和mapFromGlobal(QCursor::pos())，确认坐标映射没被缩放或 DPI 干扰
拖拽逻辑本身简单，但跨平台一致性、坐标系切换、以及和透明/圆角/自定义绘制的耦合，才是容易卡住的地方。别跳过 frameGeometry() 和 globalPos() 的组合验证，尤其在高 DPI 屏幕上。
