Karabiner-Elements 是 macOS 上非常常用的“深度改键”工具，适合这些场景：把 Caps Lock 改成 Esc/Control、把某个键位映射到一串快捷键、为外接键盘和笔记本自带键盘设置不同规则、以及做一些“按住/双击/组合键”触发的效率操作。
工具地址/参考链接：https://karabiner-elements.pqrs.org/ ，项目主页：https://github.com/pqrs-org/Karabiner-Elements
推荐两种安装方式，任选其一：
1) 官网下载安装包后按提示安装；
2) Homebrew 安装：brew install --cask karabiner-elements
首次启动后，如果你发现改键“不生效”，大概率是权限没开全。打开 macOS：系统设置 → 隐私与安全性，检查并开启以下项目（名称可能因系统版本略有差异）：
- 输入监控（Input Monitoring）：允许 Karabiner 读取键盘事件
- 辅助功能（Accessibility）：允许发送按键/控制输入
完成后建议重启一次 Karabiner-Elements（必要时重启电脑），让权限生效。
打开 Karabiner-Elements 的 Simple Modifications 页面，选择你的设备（内置键盘/外接键盘分别设置），然后添加一条映射：
caps_lock → left_control（或者 escape）。
如果你希望“单独按 Caps Lock 是 Esc，按住当 Control”，更推荐用 Complex Modifications（进阶规则）实现，因为它能区分“轻点”和“按住”。
Complex Modifications 的核心是规则（rule）。你可以从社区规则库导入，也可以自己写一条最小规则。下面是一个思路示例：轻点 Caps Lock 发送 Escape，按住当 Control（示例仅供理解结构，可按需要调整）。
{" ":"Caps as Esc / Ctrl","rules":[{"de ion":"Caps: tap=Esc, hold=Ctrl","manipulators":[{"type":"basic","from":{"key_code":"caps_lock","modifiers":{"optional":["any"]}},"to_if_alone":[{"key_code":"escape"}],"to_if_held_down":[{"key_code":"left_control"}]}]}]}
想做“双击触发”时，一般用变量（variable）+ 计时器（timeout）去判断第二次按下是否在窗口期内。这个部分配置自由度很高，建议从规则库找一个相近模板导入后再改。
Karabiner-Elements 允许按“设备”配置规则：同样是 Caps Lock，你可以让 MacBook 键盘与外接键盘行为不同。常见做法是：
- 内置键盘：轻改（例如 Caps → Ctrl）
- 外接键盘：重改（例如把右侧 Option/Command 交换、加自定义组合键）
如果你有多台 Mac，需要同步规则，优先同步配置文件而不是手动点来点去。实际操作时请注意：同步前先确认两台机器都完成权限授权，否则会出现“配置同步了但依然不生效”的假象。
1) 改键完全没反应：优先检查“输入监控/辅助功能”权限是否开启；
2) 只有部分软件不生效：某些应用可能自己抓取了快捷键，尝试更换映射或在应用内关闭冲突快捷键；
3) 外接键盘规则错乱：确认你是在正确的设备下添加修改；
4) 规则冲突：Complex 规则太多时，先逐条禁用定位冲突来源；
5) 更新后异常：到官网/仓库查看更新说明与已知问题，必要时回退到稳定版本。
只要把“权限、设备、冲突”三件事查清楚，Karabiner-Elements 基本能成为你 macOS 长期稳定的效率底座。
