为何QShortcut会占用Esc按键？两款测试程序行为差异排查

我开发的应用包含两个测试模块：

• 第一个测试模块符合预期：按下一次Esc按键可被识别，连续按三次则关闭应用，代码实现如下：

LFirstTest::LFirstTest(QWidget *parent,
                                         QObject *event_filter,
                                         SystemEvent *event, int dpi)
    : FirstTest(parent, event_filter, event) {
  (void)dpi;
  advanced_close_shortcut_ = make_unique<QShortcut>(
      QKeySequence(Qt::Key_Escape, Qt::Key_Escape, Qt::Key_Escape), this);
  advanced_close_shortcut_->setContext(Qt::WindowShortcut);
  connect(advanced_close_shortcut_.get(), &QShortcut::activated, this,
          &LFirstTest::OnClose);
}

• 第二个测试模块连续按三次Esc可关闭应用，但单次按下Esc无响应，疑似按键操作被消费，代码实现如下：

LSecondTest::LSecondTest(QWidget *parent,
                                           QObject *event_filter,
                                           SystemEvent *system_event, int dpi)
    : SecondTest(parent, event_filter, system_event) {
  (void)dpi;
  PopulateSecondStruct();
  keyboard_filter_ = new KeyboardFilter(this);
  ui->lineEdit->installEventFilter(keyboard_filter_);
  UpdateCheckBoxes();

  Second_close_shortcut_ = make_unique<QShortcut>(
      QKeySequence(Qt::Key_Escape, Qt::Key_Escape, Qt::Key_Escape), this);
  Second_close_shortcut_->setContext(Qt::WindowShortcut);
  connect(Second_close_shortcut_.get(), &QShortcut::activated, this,
          &LSecondTest::OnClose);

  DEBUG_FINISH;
}

两段代码逻辑相近，为何二者行为存在差异？

差异的核心原因集中在第二个模块的KeyboardFilter事件过滤器和QLineEdit控件的默认行为上：

• 事件过滤器的拦截作用
  第二个模块给ui->lineEdit安装了keyboard_filter_，如果该过滤器的eventFilter函数中处理了单次Esc按键事件（比如返回true标记事件已消费），那么单次Esc会被拦截，无法传递到上层窗口或其他逻辑。而连续三次Esc的快捷键能触发，是因为QShortcut的事件处理优先级更高，或者过滤器未处理组合键场景。

• QLineEdit的默认Esc行为
  即便KeyboardFilter没有明确处理Esc，当lineEdit获得焦点时，按下Esc会触发其默认行为（清空输入内容），这个操作会直接消费Esc事件，导致事件无法向上传递。第一个模块没有这类输入控件，所以单次Esc能被正常识别。

• 验证与修复方向

1. 检查KeyboardFilter::eventFilter的实现，确认是否对Qt::Key_Escape的单次按下事件做了拦截并返回true。
2. 测试lineEdit失去焦点时单次Esc是否正常响应，以此区分是控件默认行为还是过滤器的问题。
3. 若要保留过滤器功能同时让单次Esc生效，可在过滤器中不对单次Esc做消费，或者处理后返回false让事件继续传递。

内容的提问来源于stack exchange，提问作者MustSee