macOS下NSKeyDown全局按键监控代码失效，求替代方案

我来帮你搞定这个全局按键监控的问题～你用的[NSEvent addGlobalMonitorForEventsMatchingMask:NSKeyDown handler:...]没生效，大概率是权限问题或者这个API的限制导致的，下面给你分析原因+靠谱的替代方案：

先搞懂原代码失效的常见原因 #

addGlobalMonitorForEventsMatchingMask:本身是合法的全局按键监控API，但它有几个硬限制：

• 必须开启辅助功能权限：你的App必须被添加到「系统设置→隐私与安全性→辅助功能」列表里，否则这个全局监听完全不会触发。
• 无法监听App自身的按键事件：如果要监控自己App内的按键，得用addLocalMonitorForEventsMatchingMask:。
• 系统级快捷键抓不到：比如Cmd+Tab、Mission Control这类系统快捷键，这个API是拿不到的。

如果确认权限已经开了还是不行，那可以试试更底层的CGEventTap方案，它是Core Graphics提供的全局事件拦截机制，能覆盖更多场景。

替代方案：使用CGEventTap实现全局按键监控 #

这个方案需要依赖Core Graphics框架，步骤如下：

1. 检查并申请辅助功能权限 #

先判断App是否已获得权限，如果没有，引导用户去设置：

#import <ApplicationServices/ApplicationServices.h>
#import <AppKit/AppKit.h>

BOOL hasAccessibilityPermission() {
    return AXIsProcessTrusted();
}

void requestAccessibilityPermission() {
    NSDictionary *options = @{(id)kAXTrustedCheckOptionPrompt: @YES};
    AXIsProcessTrustedWithOptions((CFDictionaryRef)options);
}

2. 编写事件回调函数 #

这个函数会在有按键事件时被触发，你可以在这里处理按键逻辑：

CGEventRef keyDownCallback(CGEventTapProxy proxy, CGEventType type, CGEventRef event, void *refcon) {
    // 只处理按键按下事件
    if (type == kCGEventKeyDown) {
        // 获取按键字符
        UniCharCount length = 0;
        UniChar chars[10];
        CGEventKeyboardGetUnicodeString(event, 10, &length, chars);
        NSString *keyStr = [[NSString alloc] initWithCharacters:chars length:length];
        NSLog(@"keydown: %@", keyStr);
    }
    // 返回事件，让系统继续处理（如果想拦截事件可以返回NULL）
    return event;
}

3. 创建并启动事件Tap #

在主线程中创建事件Tap，并加入run loop：

- (void)setupGlobalKeyMonitor {
    // 先检查权限
    if (!hasAccessibilityPermission()) {
        requestAccessibilityPermission();
        return;
    }

    // 创建事件Tap：监听全局按键按下事件
    CGEventTapRef tap = CGEventTapCreate(
        kCGHIDEventTap, // 监听所有HID事件
        kCGHeadInsertEventTap, // 插入到事件链头部
        kCGEventTapOptionListenOnly, // 只监听不拦截
        kCGEventMaskBit(kCGEventKeyDown), // 只监听按键按下
        keyDownCallback, // 回调函数
        NULL
    );

    if (!tap) {
        NSLog(@"无法创建事件Tap，请检查辅助功能权限");
        return;
    }

    // 将事件Tap加入主线程的run loop
    CFRunLoopSourceRef runLoopSource = CFMachPortCreateRunLoopSource(kCFAllocatorDefault, tap, 0);
    CFRunLoopAddSource(CFRunLoopGetCurrent(), runLoopSource, kCFRunLoopCommonModes);
    CGEventTapEnable(tap, true);

    NSLog(@"全局按键监控已启动");
}

注意事项 #

• 必须在主线程中创建和运行事件Tap，否则可能无法正常工作。
• 如果需要拦截事件（比如阻止某个按键生效），可以在回调中返回NULL。
• 当App失去辅助功能权限时，事件Tap会自动失效，需要重新检查权限并重启监控。

两种方案对比 #

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