在Electron.js中如何单独注册CommandOrControl等修饰键到globalShortcut

问题原因 #

Electron 内置的 globalShortcut 模块设计上仅支持注册「普通单键」或「修饰符+普通键」的组合快捷键，不支持单独注册 Alt、Control、Shift、Meta 这类修饰键作为全局快捷键。这是因为该模块底层依赖的各操作系统原生全局快捷键API本身就将修饰符定位为组合按键的辅助标识，而非可独立触发的快捷键，属于原生能力限制，无法在globalShortcut的逻辑内绕过。

解决方案 #

根据你的使用场景可以选择两种实现方案：

方案1：仅在应用窗口激活时捕获修饰键 #

如果不需要在应用失焦时监听按键，直接在渲染层监听原生键盘事件即可，实现成本最低：

// 渲染进程代码
document.addEventListener('keydown', (e) => {
  // 匹配所有修饰键
  const modifierKeys = ['Alt', 'Control', 'Shift', 'Meta']
  if (modifierKeys.includes(e.key)) {
    console.log(`触发按键：${e.key}`)
    // 执行你需要的后续逻辑
  }
})

方案2：全局场景（应用失焦也可捕获） #

如果你的按键展示工具需要全局生效，需要替换globalShortcut为原生全局输入监听模块iohook，该模块可以捕获所有全局键盘、鼠标输入事件，单独修饰键也可以正常识别：

• 第一步 安装依赖

npm install iohook
# 安装完成后需要匹配你的Electron版本编译原生模块
npx electron-rebuild

• 第二步 主进程中使用示例

const ioHook = require('iohook');
const { app } = require('electron')

// 启动全局监听
ioHook.start()

// 监听按键按下事件
ioHook.on('keydown', (event) => {
  // 不同平台按键码可自行调整匹配
  switch(event.keycode) {
    case 56: // Alt键
      console.log('Alt按下')
      win.webContents.send('onInput', 'Alt')
      break
    case 29: // Control键
      console.log('Control按下')
      win.webContents.send('onInput', 'Control')
      break
    // 其他按键同理补充
  }
})

// 应用退出前停止监听，避免资源泄漏
app.on('will-quit', () => {
  ioHook.stop()
})

内容的提问来源于stack exchange，提问作者李孟昇