macOS升级后外接键盘映射错乱，需按序排查输入源是否为“美国英语”、修饰键是否为外接键盘单独配置（Option设为Command、Command设为Option）、Karabiner-Elements权限（辅助功能+输入监控）及Devices开关是否启用。
macOS 升级后外接键盘按键映射错乱，绝大多数情况不是键盘坏了，也不是系统崩溃，而是升级过程重置或覆盖了原有键位配置。关键要抓住三个层级：输入源、修饰键设备级设置、第三方工具权限——按顺序检查，90% 问题当场解决。
确认输入源是否被重置为非美式布局
系统升级常会把输入法切回默认（比如中文拼音或带-PC后缀的布局），导致 Shift+2 不出 @、空格变候选框、方向键失灵。这不是键盘问题，是 macOS “认错了语言”。
- 点右上角输入法图标（显示“中”“英”或国旗），直接选“美国英语”
- 若没看到，进“系统设置 → 键盘 → 输入源”，勾选“美国”，删掉 Dvorak、ABC Extended、French-AZERTY 等所有非必要输入源
- 特别注意：带“-PC”后缀的布局（如“US-PC”）会整体翻转修饰键逻辑，必须禁用
检查外接键盘修饰键是否恢复默认
升级后，“修饰键”设置通常会被清空或重置为“内建键盘”配置，导致 Win 键变 Option、Alt 键变 Command，快捷键全乱。Mac 支持每台外设单独配，这步必须做。
- 进入“系统设置 → 键盘 → 键盘快捷键 → 修饰键…”
- 弹窗顶部设备列表中，务必选中你的外接键盘（如“Logitech K380”“Keychron K8”），不是“内建键盘”
- 将“Option 键”设为 Command，“Command 键”设为 Option；若需左 Ctrl 当 Command，就把“Control 键”下拉选成 Command
- 点“好”即生效，不用重启
验证 Karabiner-Elements 权限与设备启用状态
升级后，Karabiner-Elements 的辅助功能和输入监控权限大概率被系统自动关闭，且 Devices 页面里的外接键盘开关可能被重置为关闭状态——这是空格键失灵、Caps Lock 变身 Escape 失效的最常见原因。
- 打开“系统设置 → 隐私与安全性 → 辅助功能”，勾选 Karabiner-Elements
- 在同一页面下拉到底，进“输入监控”，同样勾选 Karabiner-Elements
- 启动 Karabiner-Elements，切到“Devices”页，只开启你的外接键盘（关掉内建键盘开关）
- 再进“Simple Modifications”，确认 left_command → left_option 等规则仍在且已启用
快速排除残留驱动或冲突进程
极少数情况下，旧版驱动缓存或后台服务干扰新系统识别，表现为键盘偶尔响应、连接不稳定或部分键完全沉默。
- 按 Option + Command + Esc 强制退出 WindowServer（黑屏1–2秒后恢复），立刻重新插拔 USB 键盘或重连蓝牙
- 若仍异常，重启时按住 Option + Command + P + R 约20秒，重置 NVRAM/PRAM，清除供电与设备枚举参数
- 检查是否装有其他键盘管理软件（如 Logitech Options、Corsair iCUE），临时卸载或禁用，避免底层冲突
