MacOS快捷键失效主因是键码被重映射或占用，需依次检查：1.系统设置中“标准功能键”开关；2.系统级快捷键冲突；3.Karabiner-Elements等工具干扰；4.输入源与修饰键配置匹配性。
MacOS 快捷键失效或行为异常，多数不是键盘坏了，而是键码在系统层被重映射、拦截或占用。关键在于理清“谁在监听”“谁先响应”“谁改了原始信号”——从系统设置到第三方工具，层层排查才能准确定位。
确认「标准功能键」开关是否启用
F1–F12 默认用于亮度、音量等系统控制，IDE 或终端收不到原始 F 键信号，根源常在这里：
- 进入「系统设置 → 键盘」，勾选「将 F1、F2 等键用作标准功能键」
- 该设置对所有已连接键盘统一生效；若只想作用于某台外接键盘，需后续用 Karabiner-Elements 单独配置
- 勾选后重启应用（如 VS Code、iTerm）再测试，F5/F8 等调试键通常立刻恢复
检查系统级快捷键是否占用目标组合
即使开启标准功能键，F3、F4、Command+空格等仍可能被系统服务绑定，导致应用无法捕获：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 进「系统设置 → 键盘 → 快捷键」，左侧依次点开「调度中心」「聚焦」「输入法」「辅助功能」
- 查看右侧各项绑定的快捷键，特别注意单独 F 键（如 F3）、Command+F 键、Command+空格等高频冲突组合
- 双击冲突项，按 Esc 清空，或改为低冲突组合（如 Command+Shift+空格替代 Spotlight）
- 系统会在冲突快捷键旁显示黄色警告三角，留意这个视觉提示
排查 Karabiner-Elements 等键映射工具干扰
Karabiner-Elements 是最常引发深层冲突的工具，尤其当它对同一设备启用了规则又开了全局监听：
- 打开 Karabiner-Elements →「Devices」页，临时关闭外接键盘开关，观察 F 键是否恢复
- 若恢复，说明问题出在它的规则中：切到「Complex Modifications」→「Rules」，禁用含 f1/f2/mission_control/display_brightness 的条目
- 注意某些预设规则（如“Function keys to standard function keys”）会与系统设置重复覆盖，建议禁用
- 确保「辅助功能」和「输入监控」权限已在「系统设置 → 隐私与安全性」中完整授予
验证输入源与修饰键配置是否匹配外设
外置键盘（尤其是 Windows 布局）常因输入源或修饰键错配导致 Ctrl/Cmd/Option 功能错乱：
- 右上角点击输入法图标，确认当前为「美国英语」；避免使用 Dvorak、ABC Extended 或中文拼音输入源来打英文命令
- 进「系统设置 → 键盘 → 修饰键」，顶部设备列表中必须选中你的外接键盘（如“Logitech K380”），再分别指定 Option 键、Command 键对应物理位置
- 例如 Windows 键盘上，左 Alt 应设为 Option，左 Win 应设为 Command；设错会导致 Command+C 失效或粘滞
