如何实现macOS原生截图的鼠标焦点保持行为

你遇到的tooltip消失问题和截图接口无关——你当前使用的CGWindowListCreateImage本身可以正常捕获到tooltip这类临时窗口内容，问题出在你创建的全屏透明覆盖视图触发了系统焦点切换规则：只要你的应用窗口（哪怕完全透明）被设为接收事件的关键窗口，系统会自动清除前台其他应用的鼠标悬停状态、临时UI响应状态，依赖悬停触发的tooltip会立刻被销毁。
苹果原生截图不会触发该问题，核心是它的选区交互层没有走普通应用窗口的焦点抢占逻辑。

苹果没有用特殊的私有API实现该效果，你可以直接通过公开API复刻一致体验，核心配置如下：

• 替换普通NSWindow作为覆盖层：使用NSPanel子类创建全屏蒙层窗口，设置窗口级别为CGShieldingWindowLevel() + 1，保证显示在所有普通应用、菜单、tooltip上层
• 给窗口配置以下属性，确保显示时完全不抢占焦点：

  panel.styleMask = NSWindowStyleMaskNonactivatingPanel | NSWindowStyleMaskBorderless;
  panel.collectionBehavior = NSWindowCollectionBehaviorCanJoinAllSpaces | NSWindowCollectionBehaviorStationary | NSWindowCollectionBehaviorIgnoresCycle;
  panel.hidesOnDeactivate = NO;
  panel.ignoresMouseEvents = NO;
  [panel setReleasedWhenClosed:NO];
  

• 全局快捷键触发后，直接调用[panel orderFrontRegardless]显示窗口，绝对不要调用[NSApp activateIgnoringOtherApps:YES]或者任何会把你的App切到前台的方法，此时前台焦点仍然留在原应用上，tooltip不会消失，同时你的NSPanel可以正常接收鼠标拖拽事件完成选区绘制。
• 如果需要更精细的事件控制，可以搭配CGEventTap在系统事件层拦截鼠标、键盘事件，不需要依赖窗口本身的事件响应链，稳定性更高。

如果不想自己处理多屏兼容、焦点适配、Retina截图等细碎逻辑，可以直接接入系统原生截图流程，体验和用户按Cmd+Shift+4完全一致：

• macOS 10.14+ 可直接使用ScreencaptureKit框架的交互式选区截图API，直接注册回调即可拿到用户框选区域的截图结果，不需要自己写任何选区UI
• 兼容更低版本可以通过NSTask调用系统内置的screencapture命令行工具，传入-i参数启动交互式区域截图，指定输出路径后即可读取生成的截图文件，代码量极少且完全和系统行为一致。

避坑提示：不要尝试通过把覆盖视图设为忽略鼠标事件、再手动计算鼠标位置的方式实现选区，这种方案无法处理多显示器DPI差异、鼠标加速、系统级手势冲突等边缘问题，长期维护成本极高。

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