macOS/Quartz/pynput环境下如何屏蔽无Unicode值的功能键？

直接替换判断条件触发报错的核心原因是：代码中未通过Quartz接口从事件对象提取虚拟键码，直接引用未定义的virtualKey变量必然触发运行时错误。

Control、Command这类功能键没有对应的Unicode字符值，无法通过CGEventKeyboardGetUnicodeString接口识别，需要读取事件携带的虚拟键码字段做判断，具体通过CGEventGetIntegerValueField接口传入kCGKeyboardEventKeycode字段标识即可拿到按键对应的硬件虚拟键码。

常用功能键对应虚拟键码参考：

• 左Control：0x3B
• 右Control：0x3E
• 左Command：0x37
• 右Command：0x36
• 左Option：0x3A
• 右Option：0x3D
• 左Shift：0x38
• 右Shift：0x3C
• Caps Lock：0x39

可正常拦截字符键+功能键的完整实现代码如下：

def darwin_intercept(event_type, event):
    import Quartz
    # 读取按键对应Unicode字符，用于普通字符键判断
    length, chars = Quartz.CGEventKeyboardGetUnicodeString(
        event, 100, None, None)
    # 读取按键虚拟键码，用于功能键判断
    virtual_key = Quartz.CGEventGetIntegerValueField(
        event, Quartz.kCGKeyboardEventKeycode
    )

    # 拦截字符x
    if length > 0 and chars == 'x':
        return None
    # 拦截左Control键，可根据需求替换为其他功能键的键码
    if virtual_key == 0x3B:
        return None

    return event

实现说明：

• 虚拟键码是键盘硬件上报的固定值，不受输入法、大小写锁定、修饰键状态影响，识别功能键稳定性更高
• 如果需要识别组合键（比如Control+x），可额外调用Quartz.CGEventGetFlags(event)获取当前修饰键按下状态，配合虚拟键码做联合判断
• 拦截逻辑直接返回None即可屏蔽对应按键的系统传递，正常事件直接返回原event对象即可

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