在macOS上禁用Electron面板窗口顶部可移动区域点击聚焦行为的方法

我之前做类似Spotlight的悬浮面板时，也碰到过这个头疼的问题——macOS上Electron的panel窗口哪怕设了frame: false，顶部那28px的系统默认拖动区域还是会在点击时激活应用，把菜单栏顶出来，完全破坏了Spotlight那种“不打扰”的感觉。折腾了好一阵，终于找到几个关键的设置组合，完美解决了这个问题，下面给你一步步说清楚：

核心思路 #

要实现Spotlight的效果，关键是让应用处于非激活状态（不会抢占菜单栏），同时保证窗口本身可以接收用户输入（比如搜索框能打字）。macOS的应用激活策略和Electron的窗口显示方法是核心控制点。

具体代码修改 #

1. 设置应用激活策略为accessory

在Electron初始化完成后，针对macOS平台设置应用的激活策略为accessory，这样应用永远不会成为“激活”状态，也就不会把菜单栏切换到自己的：

app.on("ready", () => {
  // 仅在macOS上生效
  if (process.platform === 'darwin') {
    app.setActivationPolicy('accessory');
  }
  createWindow();
});

2. 调整面板窗口的显示方式

把原来的quickWindow?.show()改成showInactive()，这个方法会显示窗口但不会激活应用，完美契合Spotlight的打开逻辑：

globalShortcut.register("CmdOrCtrl+Shift+1", () => {
  if (quickWindow) {
    if (quickWindow.isVisible()) {
      quickWindow.hide();
    } else {
      // 显示窗口但不激活应用
      quickWindow.showInactive();
    }
  }
});

3. 优化窗口配置（保留原有必要设置）

你的quickWindow配置已经很接近了，确保保留以下几个关键项即可：

quickWindow = new BrowserWindow({
  type: "panel",
  frame: false,
  show: false,
  height: 600,
  width: 600,
  movable: false,
  focusable: true, // 必须设为true，否则窗口内元素无法获得焦点
  skipTaskbar: true,
  maximizable: false,
  vibrancy: 'sidebar',
  alwaysOnTop: true, // 可选，模拟Spotlight置顶效果
  webPreferences: {
    preload: QUICK_WINDOW_PRELOAD_WEBPACK_ENTRY,
  },
});

为什么这些设置有效？ #

• app.setActivationPolicy('accessory')：这是macOS特有的API，标记应用为“辅助工具”，系统会禁止它激活菜单栏，哪怕用户点击窗口也不会切换应用状态。
• showInactive()：Electron专门提供的方法，用来显示窗口但不触发应用激活，刚好匹配我们的需求。
• focusable: true：保证窗口内的输入控件（比如搜索框）可以正常获取焦点，用户能正常输入内容，不会因为应用非激活而无法操作。

额外注意事项 #

• 如果你需要在某些场景下让应用临时激活（比如打开主窗口时），可以在主窗口显示时调用app.setActivationPolicy('regular')，关闭主窗口后再切回accessory。
• 测试时要注意：macOS的系统设置里如果有“聚焦”的快捷键冲突，记得先调整，避免影响你的快捷键触发。

内容来源于stack exchange