macOS功能键失效主因是系统快捷键设置未启用“标准功能键”或被Karabiner-Elements等工具拦截；需在「系统设置→键盘」勾选该选项，并检查快捷键占用、工具规则及应用层屏蔽。
功能键（f1–f12）在 macos 上失效，多数不是硬件故障，而是快捷键映射表被系统或第三方工具覆盖、重定向或禁用所致。核心问题在于：这些键默认被 macos 用于调节亮度、音量、mission control 等系统功能，而“将 f1、f2 等用作标准功能键”的开关一旦关闭，或被 karabiner-elements、bettertouchtool 等工具拦截，就会导致 ide、终端、浏览器等应用无法接收到原始 f 键信号。
检查并开启“使用所有 F1、F2 等键作为标准功能键”
这是最基础也最容易被忽略的设置。macOS 默认把 F1–F12 绑定为特殊功能，需手动切换才能让它们输出原始键码：
- 进入「系统设置」→「键盘」→ 右侧勾选「将 F1、F2 等键用作标准功能键」
- 该选项对所有键盘（包括内置和外接）统一生效；若只希望某台外接键盘启用此行为，需配合 Karabiner-Elements 单独配置
- 勾选后，F1–F12 才会真正发送 F1、F2 等 key_code，否则按 F5 实际触发的是「降低亮度」，应用收不到 F5 事件
排查 Karabiner-Elements 或其他键映射工具的全局拦截
Karabiner-Elements 若在「Devices」页启用了外接键盘，又在「Simple Modifications」或「Complex Modifications」中设置了 F 键相关规则（例如把 F1 映射成 Mission Control），就会覆盖系统级功能键逻辑：
- 打开 Karabiner-Elements 主界面 → 切换到「Devices」页 → 关闭外接键盘的开关（临时禁用），观察 F 键是否恢复
- 若恢复，说明问题出在它的规则里；返回「Complex Modifications」→ 点击「Rules」→ 查找含
f1、f2、mission_control、display_brightness_decrement的条目，逐一禁用测试 - 注意：某些预设规则（如 “Function keys to standard function keys”）看似合理，实则会强制重映射，与系统设置冲突
验证系统快捷键是否占用对应 F 键
即使开启了“标准功能键”，部分 F 键仍可能被系统服务劫持——比如 F3 默认触发 Mission Control，F4 触发 Launchpad。这些绑定若未被禁用，仍可能干扰应用行为：
- 进入「系统设置」→「键盘」→「快捷键」→ 左侧选择「调度中心」
- 查看右侧「显示调度中心」「显示桌面」「显示全部窗口」等项目绑定的快捷键，确认是否为单独的 F 键（如 F3）或修饰键+F 键组合（如 ⌘+F3）
- 若有，双击该快捷键区域，按 Esc 清空，或改为其他组合（如 ⌘+⌥+F3），释放原始 F 键
- 同样检查「屏幕快照」「听写」「Spotlight」等类别，避免 F12 被占用于截图、F5 被占用于刷新听写
排除浏览器或应用自身的快捷键屏蔽
某些网页（如 Web IDE、Notion、Figma）或本地应用（如 VS Code、IntelliJ）会主动捕获 F 键并阻止其透传给系统，造成“按了没反应”的假象：
- 在 Safari 或 Chrome 中，按下 ⌥+⌘+U（查看源代码）或 ⌥+⌘+C（开发者工具），确认是否能正常唤起——若不能，说明是系统层问题；若能但 F5 刷新无效，则是网页拦截
- 在 VS Code 中，打开命令面板（⇧+⌘+P），输入 “Open Keyboard Shortcuts (JSON)” → 检查是否有
"key": "f5"被重定义为其他命令，或存在"when": "editorTextFocus"类条件限制 - 临时退出所有第三方工具（Alfred、Raycast、Rectangle），再测试 F 键，可快速定位是否为后台进程劫持
