使用NSEvent.EventTypeMask添加全局键盘监视器无触发问题

核心问题 #

全局键盘监视器未触发，主要源于两个关键问题：

1. 辅助功能权限未正确生效：即便调用了AXIsProcessTrustedWithOptions，用户可能未在系统设置中确认权限，或者权限校验逻辑存在疏漏。
2. 按键判断逻辑不可靠：使用event.characters判断按键会受输入法、大写锁定状态影响，无法精准识别目标按键。

解决步骤 #

1. 配置权限描述（必填） #

在应用的Info.plist中添加以下权限说明，否则系统会拒绝授予辅助功能权限：

<key>NSAppleEventsUsageDescription</key>
<string>需要监控全局键盘事件以管理复制粘贴历史</string>
<key>NSAccessibilityUsageDescription</key>
<string>需要辅助功能权限来监控全局键盘操作</string>

2. 修正按键监控逻辑 #

改用keyCode精准识别按键，同时排除其他干扰修饰键（如Shift、Option），修改startMonitoringKeys方法：

func startMonitoringKeys() {
    keyMonitor = NSEvent.addGlobalMonitorForEvents(matching: .keyDown) { event in
        // 仅保留Command修饰键，排除其他修饰键干扰
        let onlyCommand = event.modifierFlags.intersection(.deviceIndependentFlagsMask) == .command
        
        // 复制：Command + C（keyCode = 8）
        if onlyCommand && event.keyCode == 8 {
            print("复制命令触发")
        }
        // 粘贴：Command + V（keyCode = 9）
        if onlyCommand && event.keyCode == 9 {
            print("粘贴命令触发")
        }
    }
}

3. 优化权限校验流程 #

在applicationDidFinishLaunching中，若权限未授予，直接引导用户前往系统设置开启：

func applicationDidFinishLaunching(_ notification: Notification) {
    print("应用启动")
    let options: NSDictionary = [
        kAXTrustedCheckOptionPrompt.takeUnretainedValue() as NSString: true
    ]
    let accessEnabled = AXIsProcessTrustedWithOptions(options)
    print("辅助功能权限状态：\(accessEnabled)")
    
    if !accessEnabled {
        let alert = NSAlert()
        alert.messageText = "需要辅助功能权限"
        alert.informativeText = "请前往系统设置 > 隐私与安全性 > 辅助功能，开启本应用的权限以监控全局键盘操作。"
        alert.addButton(withTitle: "前往设置")
        alert.addButton(withTitle: "取消")
        if alert.runModal() == .alertFirstButtonReturn {
            NSWorkspace.shared.open(URL(string: "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility")!)
        }
    }
    
    startMonitoringKeys()
}

关键说明 #

• addGlobalMonitorForEvents本身不会捕获当前应用激活状态下的键盘事件，这是系统设计限制，符合你需要的非激活状态监控需求。
• 若权限已勾选但仍未触发，尝试重启应用或系统，确保权限完全生效。

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