目录
前言（先给结论）
一、最高频：事件被父控件 / 兄弟控件挡了（Z-order 问题）
1️. StackUnder / raise / 透明控件盖在上面
2️. Layout 里控件实际没铺满，但 parent 收了事件
二、Qt 事件机制级：你被 Qt::WA_XXX 坑了（高频）
3️. setMouseTracking(false)+ 只等 Press
4️. Qt::WA_TransparentForMouseEvents
5️. Qt::WA_NoMousePropagation（事件没传出去）
三、被事件过滤器“截胡”
6️. eventFilter return true 吞事件
7️. installEventFilter装错对象
四、窗口 / 状态属性把路堵死
8️. setEnabled(false)/ setVisible(false)
9️. Qt::Tool / Qt::Popup / Qt::FramelessWindowHint窗口标志异常
五、事件根本没 override
10. 忘了 protected/ 函数签名写错
1️1. 没 Q_OBJECT+ signals/slots 乱用
六、OpenGL / 绘图控件 / 第三方库的坑
1️2. QOpenGLWidget / QQuickWidget默认不吃事件？
1️3. 自己 paintEvent里 update()死循环
七、终极排查 Checklist
八、总结
觉得有用，就请您帮忙点赞转发收藏吧，您的鼓励是我创作的动力，多谢看官。
由于能力水平有限，文中的错误或不严谨的地方在所难免，还请批评指正。
在使用 Qt 框架开发图形界面应用程序时，遇到鼠标事件不响应的问题可能是由多种原因引起的。以下是一些常见的原因和相应的解决方案，可以帮助你解决 Qt Widgets 鼠标事件不响应的问题。常见的问题：Widget 没启用鼠标事件/事件过滤器截胡/被其他控件遮挡/Qt::WA_TransparentForMouseEvents使用不当等。
前言（先给结论）
Qt 里鼠标事件不触发，90% 不是 Qt bug，而是事件被“截胡 / 挡住 / 没资格收”。
比起mousePressEvent没写对，更常见的是：
事件根本没走到你这个类。
下面按「从深到浅、从高频到低频」把坑列一遍，适合直接当排查 Checklist 贴进博客。
一、最高频：事件被父控件 / 兄弟控件挡了（Z-order 问题）
1️. StackUnder / raise / 透明控件盖在上面
label->raise(); // label 挡住了下面的 widget stackedWidget->currentWidget(); // 当前页不是你以为的那个QLabel / QWidget哪怕完全透明 / 不画内容，也能吃事件Designer 里拖的控件，后拖的默认在上层
排查：
widget->setStyleSheet("background: rgba(255,0,0,50);");一秒定位谁挡你。
2️. Layout 里控件实际没铺满，但 parent 收了事件
子控件 sizeHint 很小
parent 有 padding / margin
你点的是 parent 空白区，不是 child
现象：
parent 的
mousePressEvent能进，child 进不了
二、Qt 事件机制级：你被 Qt::WA_XXX 坑了（高频）
3️.setMouseTracking(false)+ 只等 Press
mouseMoveEvent默认必须按下鼠标才触发很多人以为 hover 没反应 = 控件坏了
解决：
setMouseTracking(true);4️.Qt::WA_TransparentForMouseEvents
child->setAttribute(Qt::WA_TransparentForMouseEvents);事件直接穿透
Designer 属性里也能勾，极易手滑
排查一句：
qDebug() << widget->testAttribute(Qt::WA_TransparentForMouseEvents);5️.Qt::WA_NoMousePropagation（事件没传出去）
自己能收到，但 parent 收不到
或你指望 eventFilter 拦，结果没冒泡
三、被事件过滤器“截胡”
6️.eventFilterreturn true 吞事件
bool MyFilter::eventFilter(QObject *o, QEvent *e) { if (e->type() == QEvent::MouseButtonPress) return true; // ❌ 吞了 return false; }常见场景：
全局 hook（防误触）
拖拽管理器
手势识别
口诀：
Qt 事件链里，return true = 到此为止
7️.installEventFilter装错对象
parent->installEventFilter(child); // 方向反了记住一句话：
installEventFilter 的是“接收者”，参数才是“监听者”
四、窗口 / 状态属性把路堵死
8️.setEnabled(false)/setVisible(false)
setEnabled(false)：鼠标事件直接不进setVisible(false)：你点的是空气
注意：
Layout 里
addWidget但没show()父类
setEnabled(false)会级联禁用子控件
9️.Qt::Tool / Qt::Popup / Qt::FramelessWindowHint窗口标志异常
Qt::Popup：只认QWidget::grabMouse()逻辑无焦点窗口 + 点击穿透系统
排查：
qDebug() << windowFlags();五、事件根本没 override
10. 忘了protected/ 函数签名写错
// ❌ 错 void mousePressEvent(QMouseEvent e); // 没引用、没 override void MousePressEvent(QMouseEvent*); // 大小写错了正确姿势：
protected: void mousePressEvent(QMouseEvent *event) override;C++17+ 强迫症写法：
void mousePressEvent(QMouseEvent *event) override final;1️1. 没Q_OBJECT+ signals/slots 乱用
虽然鼠标事件本身不靠 moc，但：
你继承的自定义控件没
Q_OBJECTuic 生成的父类 + 自己改继承
运行时 RTTI / event 分发直接走错 vtable（极端但真实）
排查：
rm -rf build && cmake .. && make看还有没有 moc 警告。
六、OpenGL / 绘图控件 / 第三方库的坑
1️2.QOpenGLWidget / QQuickWidget默认不吃事件？
QOpenGLWidget有独立 native window父子控件事件边界变复杂
QGraphicsView里 item 没setAcceptedMouseButtons()
GraphicsItem 必写：
setAcceptedMouseButtons(Qt::LeftButton); setFlag(QGraphicsItem::ItemIsSelectable);1️3. 自己paintEvent里update()死循环
疯狂重绘 → 事件队列饥饿
鼠标看起来“卡死不响应”
七、终极排查 Checklist
把这段贴项目里：
bool MyWidget::event(QEvent *e) { if (e->type() == QEvent::MouseButtonPress) qDebug() << objectName() << "got raw event"; return QWidget::event(e); }能进event()→ 事件到了
进不了 → 被挡 / 穿透 / 窗口没激活
八、总结
Qt 的鼠标事件不是“点就到”，而是：
窗口系统 → QWidgetWindow → parent → child → eventFilter → event() → mousePressEvent
任何一个环节 return true / WA_属性 / Z-order，都能让你的控件安静如鸡。
所以别再问“为什么 mousePressEvent 不调用”了——
先问是不是挡了，再问是不是吞了，最后才看 override 错没错。
