Karabiner 版

• 1: 安装与 Hyper 基础
• 2: 导航、删除与鼠标
• 3: 窗口与开发者工作流
• 4: 系统功能与参考
• 5: 配置器
• 6: 早期版本
  • 6.1: Mac V2
  • 6.2: Mac V1
  • 6.3: Windows

1 - 安装与 Hyper 基础

Capslock Enhancement V3 当前版本 面向 macOS 与 Karabiner-Elements。除此之外没有别的东西需要安装：这套配置就是一组由 Karabiner 解释执行的复杂修饰规则，不会新增常驻进程，也不需要在你的机器上编译任何东西。

安装

brew install --cask karabiner-elements

karabiner://karabiner/assets/complex_modifications/import?url=https://raw.githubusercontent.com/Vonng/Capslock/main/mac_v3/capslock.json

十条规则

键位图按用途着色，因此一个键的邻居就大致告诉你它做什么。整份配置由十条 Karabiner 规则组成，一类一条，可以逐条启用。

单击、按住与 Hyper

Caps Lock 现在有两种永不冲突的行为，因为一种在松开时判定，另一种在按住期间生效。

✱ 并不是某种私有信号。Karabiner 把按住的 Caps Lock 改写成同时按下右侧全部四个修饰键 ⌘+ 加 ⌥+ 加 ⌃+ 加 ⇧。这带来两个值得理解的结果：

• 其他软件收到的仍然是普通组合键。 Alfred、Moom、Magnet、Raycast 以及各类 IDE 收到的是 ⌃+ 加 ⌥+ 加 ⇧+ 加 ⌘ 加一个字母，可以像绑定其他快捷键一样绑定它。
• 规则没有占用的键会原样透传。 ✱+ 加 A 之所以没有自己的规则，正是为了把它让给窗口管理器。任何你想交给其他应用的键都可以照此办理。

十六个控制平面

Hyper 保持按下时，四个左侧修饰键充当四个二进制开关。把它们当成四个比特位读，就得到 0–15 号平面：

⌘ = 1 · ⌥ = 2 · ⌃ = 4 · ⇧ = 8。

九个平面已被使用，另外七个是留给你自己规则的空间。打开配置器可以交互式浏览同样的十六行，并查看所选平面上每个键的实际行为。

平面的划分并不随意。在整份配置里，同一个修饰键始终保持同一种含义，这也是这套布局可以「学一次」而不是「逐键背诵」的原因：

兼容性

• 这套布局以 ANSI 键盘为蓝本，内置键盘与外接键盘表现一致。ISO 布局同样可用， 只是物理位置不同的那两个键可能落在意料之外的地方。
• 鼠标键需要一块数字小键盘，其余功能在 87 键键盘上都能用。
• 更旧的 macOS 需要归档版本的 Karabiner-Elements，不在本指南覆盖范围内。

下一步

继续阅读导航、删除与鼠标控制。

2 - 导航、删除与鼠标

键盘核心区的粉色与棕色区域承载这套布局最高频的操作。导航与删除两个类目合计占据 V3.1 中 282 条映射里的 114 条，这也是整套布局里最值得先学的部分。

导航键组

H J K L 分别向左、下、上、右移动，与 Vim 完全一致；正上方的 U I O P 把同样的思路扩展到整页与整行：Page Up、Home、End、Page Down。

这八个键是全键盘上唯一在九个平面上都有映射的按键。下面每一组平面负责一件事， 合起来占据 V3.1 中 282 条映射里的 72 条。

移动与选择文本

文本层的规律只有一条：按住 ⌘，移动就变成选择，因为规则发出的是同一个方向键再加上 ⇧。再叠加 ⌥，选择单位随之扩大：一个字符变成一个词，一行变成三行，半行变成整行。

这也是 ✱+ 加 ⌘+ 加 ⌥+ 加 I 先跳到行尾、再反向选回行首的原因：不碰鼠标就精确选中一整行，这是最快的做法。

切换应用、窗口、标签页与桌面

⇧ 在容器之间移动，也就是你正在看的那个东西，而不是里面的文字；⌃ 则是在和窗口服务器对话。

从核心区控制指针与滚轮

另外四个平面把同样这八个键变成鼠标，双手完全不必移动。两种模式下， ⇧ 都是那个「油门」。

只有鼠标中键是例外：它不在导航键上，而在 ✱+ 加 ⌥+ 加 ↩。

方向键鼠标控制

物理方向键同样可以驱动指针，很多时候比切到核心区更顺手。这里 ⌥ 减速、⌘ 加速，指针与滚轮两种模式都适用。

五个鼠标按键全都落在 ↩ 上：

语义删除

N M , . 位于导航键正下方。左边一对删除光标之前的内容，右边一对删除光标之后的内容，叠加修饰键则放大删除单位。

有两处刻意打破了规律。✱+ 加 ⌥+ 加 N 与 ✱+ 加 ⌥+ 加 . 都发送 ⌘+ 加 ⌫，把光标到行首的内容一次清空，所以这一组的两个外侧键就是「这行不要了」。而 ✱+ 加 ⌥+ 加 M 与 ✱+ 加 ⌥+ 加 , 根本不删除：它们发出的是 ⌥+ 加 ⇧+ 加 ↓ 与 ⌥+ 加 ⇧+ 加 ↑， 也就是 IntelliJ、VS Code 等编辑器通用的上下移动整行。

数字键盘鼠标

如果键盘带小键盘，Hyper 会把整块小键盘变成一只鼠标：数字键给出以 5 为中心的八个方向，顶行滚动，底边与右侧是五个按键。

速度修饰键与别处一致：⌥ 把指针降到一半，⌘ 提升一倍，再加 ⇧ 则把指针移动换成同档速度的滚轮移动。

下一步

继续阅读窗口、应用、终端、剪贴板与字符输入。

3 - 窗口与开发者工作流

这套布局为最容易打断开发者心流的操作安排了多个颜色区域：切换窗口、启动工具、发送终端信号、临时存放文本，以及输入标点符号。

窗口管理

⇥ Q W A S 构成键盘左侧的淡蓝色区块，负责关闭与轮换：小到一个标签页， 大到整个登录会话。

其中两行值得单独说明。

✱+ 加 A 是故意不映射的。因为 Hyper 就是右侧的 ⌃+ 加 ⌥+ 加 ⇧+ 加 ⌘，没有被占用的键会原样透传给正在监听的应用。在 Moom、Magnet 或任何窗口管理器里绑定 ⌃+ 加 ⌥+ 加 ⇧+ 加 ⌘+ 加 A，它就成了你的布局键。Slate 仅作为历史示例保留。

睡眠并不是按键，而是 Shell 命令：✱+ 加 ⇧+ 加 W 执行 pmset sleepnow，✱+ 加 ⌥+ 加 W 执行 pmset displaysleepnow。 Karabiner 不需要额外权限，但如果有模态对话框正在阻塞输入，它们不会触发。

应用捷径

黄色按键在三个平面上启动或切换六个应用。每条规则都是一句普通的 open -a Shell 命令，也就是说目标是按应用名称匹配的，这正是它们可以安全改写的原因。

由于 open -a 既能启动也能切换，一个键就顶掉了点 Dock 图标和在 ⌘+ 加 ⇥ 里翻找。如果应用已经在最前，再按一次不会有任何反应： 它不是开关。

终端与 IDE 控制

绿色按键把 Shell 高频使用的控制组合挪到右手，左手不必再在打字中途扭成 ⌃ 加字母的姿势。

✱+ 加 C 与 ✱+ 加 ⌘+ 加 C 和黄色按键一样是 open -a 命令，可以改指向你自己在用的助手。

五个文本剪贴板

数字键 6–0 变成五个互相独立的文本剪贴板。 ✱+ 加 ⌘ 加数字把当前选中内容复制进该槽位，✱ 加数字再把它粘贴回来。

这种实现方式带来两个结果，而且都很有用：

• **槽位能挺过注销、重启，也不受系统剪贴板影响。**它们就是普通文件，cat ~/.clip7 就能在终端里读出来，任何编辑器都可以往里写，完全不必碰键盘。
• **它们只保存纯文本。**复制图片或文件进槽位，存下来的是 pbpaste 渲染出的文本，而不是原始对象。

面向代码的上档变换

橙色按键把程序员整天都在敲的标点挪到核心区附近，输入括号不必再做 ⇧ 体操。

括号键是最大的收益：[ 与 ] 在同样的两个位置上给出圆括号、花括号、尖括号三对。又因为 ; 与 ' 紧挨着，: = 和 ! = 都是相邻连击，这就是 Go 和 Rust 里的赋值与比较反而比在原生键盘上更快的原因。

✱+ 加 / 与 ✱+ 加 \ 都发送 ⌘+ 加 /，也就是几乎所有编辑器与 IDE 通用的注释快捷键。

下一步

在系统功能与参考中查阅功能键、截图、符号、定制与问题排查。

4 - 系统功能与参考

本页集中收录更适合查阅、而不是顺序学习的映射与项目资料。

功能键与系统控制

F1–F12 默认作为标准功能键；按住 Hyper 时发送对应的媒体或系统功能。青色区块覆盖整个顶行以及截图键。

截图键遵循同一条约定：单独的 Hyper 组合把截图放进剪贴板，再加 ⌘ 则写成桌面上的文件。

全尺寸键盘上的六键导航区提供同样三项系统控制的细粒度版本：它发出的是 ⇧+ 加 ⌥ 加媒体键，也就是 macOS 自带的四分之一步长修饰键。

符号

✱ 是 Heavy Asterisk。普通星号的 ASCII 码正好是 42，也就是生命、宇宙以及任何事情的终极答案。

一条规则长什么样

配置里的每一条映射都是同一个形状。读懂一条，整个文件就都可读了，下面的定制一节也就不再吓人：

- description: 'control + h = ctrl + left (prev desktop)'
  type: basic
  from:
    key_code: h
    modifiers:
      mandatory: [left_control, right_command, right_control, right_shift, right_option]
  to:
    - key_code: left_arrow
      modifiers: [left_control]

mandatory 里那四个 right_* 修饰键就是 Hyper 本身，由 Hyper 驱动的每一条规则里都有它们。旁边还有什么（这里是 left_control）就决定了控制平面。to 则是应用最终收到的东西。

V3.1 的变化

V2 只用到了少数几个平面。V3 引入四位二进制的平面模型，布局才得以扩展到 282 条映射而不至于变得随意。更早的配置列在版本中。

随后 V3.1 有意调整了一些老用户会察觉的默认值：

• 剪贴板移到 6–0，1–5 不再是槽位；
• C 与 ⌘+ 加 C 启动 Codex 和 Claude；
• Spotlight 与 Alfred 5 取代 Launchpad 和 Alfred 4；
• F13 与 F14 改为截图，不再是上一首 / 下一首；
• ⌘+ 加 D 执行的是定义，而不是打开词典。

定制配置

YAML 是唯一的事实来源，JSON 由它生成。重新生成只需要一条命令，以及 yq v4：

make -C mac_v3 compile

一个不错的入门定制是占用七个空闲平面之一：复制任意一条规则，改掉 mandatory 里的左侧修饰键，你就拥有了一整个键盘、且不与任何现有映射冲突的空间： 5 号平面（✱+ 加 ⌘+ 加 ⌃）与 7 号平面（✱+ 加 ⌘+ 加 ⌥+ 加 ⌃） 都是完全空的。

请始终保持 YAML 与生成的 JSON 同步：导入链接与 Karabiner 陈列馆发布的都是那份 JSON。

常见问题与排查

某个组合完全没反应。

先检查 Settings › Complex Modifications：十条规则是分别启用的，刚导入时一条都没开。如果规则已启用，就打开 Karabiner-EventViewer 再按一次，它会显示真正到达系统的按键，从而区分「规则没生效」和「应用吞掉了这个快捷键」。

Caps Lock 能发 Escape，但别的都不管用。

这是只启用了第一条规则的典型症状。CapsLock to Hyper 只提供单击 Escape 与按住 Hyper，Hyper 之后能做什么，靠的是另外九条规则。

为什么某些组合会触发 macOS 系统诊断？

Issue #30 记录了 ⌘+ 加 ⌥+ 加 ⌃+ 加 ⇧+ 加 . 可能触发 macOS 系统诊断。若与自定义平面冲突， 请重新映射该系统快捷键。

为什么没有 Linux 支持？

Linux 桌面环境差异较大，作者本人主要通过 macOS 终端使用 Linux。原生支持可以使用 xmodmap 等工具实现，欢迎贡献。

仓库中为什么保留旧 macOS 版本？

旧版 Karabiner 使用 XML；macOS Sierra 以后由 Karabiner-Elements 接替，因此旧配置继续保留给历史系统。它们列在版本中。

这套设计是原创的吗？

最早的 AutoHotkey 版本可追溯到 2013 年，第一个 Mac 版本发布于 2015 年。当前配置长期收录于 Karabiner-Elements 复杂规则陈列馆。

项目

Capslock Enhancement 由 Vonng 维护，采用 Apache License 2.0。源码、版本与问题跟踪位于 GitHub。

5 - 配置器

从表格中选择控制平面，或直接点击键盘上的左侧修饰键，再点击任意按键查看它背后的 Karabiner 规则。启动应用的按键可以改名。所有修改只保存在当前页面，直到你复制或下载 JSON；不会发送到任何地方。

交互式配置器只在网页上运行：它展示全部十六个控制平面，可以改写应用捷径，并导出可导入 Karabiner-Elements 的 JSON。当前配置（3.1.0）： capslock.json

导入你的版本

1. 点击下载配置，得到的文件名为 capslock-3.1.0-custom.json。
2. 把它放进 ~/.config/karabiner/assets/complex_modifications/。
3. 在 Karabiner-Elements › Settings › Complex Modifications 中移除原有的 Capslock 规则，选择 Add predefined rule，再启用你这份文件中的规则。

安装页上的导入链接始终获取未经修改的配置，想恢复默认值时用它即可。

6 - 早期版本

在 V3 之前，Capslock 布局先后有过三个版本：一份 Windows 上的 AutoHotkey 脚本、一份为 OS X 上的旧版 Karabiner 编写的 XML 配置，以及第一套 Karabiner-Elements 规则。它们的文件仍保存在 GitHub 仓库中。这几页记录了每个版本的功能和当年的安装方法。

两个 Mac 版本都用 ✱ 表示 Hyper，这几页沿用这一写法：✱ H 即按住 Caps Lock 再按 H。

6.1 - Mac V2

Mac V2 是 Capslock 的第一个 Karabiner-Elements 版本。Karabiner-Elements 是为适配 macOS Sierra 而重写的新版 Karabiner。V2 由十条复杂修改（Complex Modifications）规则组成：轻按 Caps Lock 发送 Escape；按住则变成 Hyper（✱），由 Karabiner-Elements 同时按住右侧的 ⌃ ⌥ ⇧ ⌘ 四个修饰键。因此 Hyper 仍可与左侧修饰键组合，大多数应用也能正常识别。

Caps Lock 键

导航

单按 Hyper 时移动光标；再加一个左侧修饰键，则分别用于选择文本、移动指针、切换标签页与应用，或操作桌面空间。

鼠标

删除

窗口与标签页

终端按键

应用

README 建议把这些换成你自己常用的应用。

功能键

V2 假定 F1 到 F12 作为标准功能键使用，按住 Hyper 时再恢复键帽上印的功能。对于带 Touch Bar 的 MacBook Pro，README 建议在 Karabiner-Elements › Function Keys 中打开「Use all F1, F2, etc. keys as standard function keys」。

全尺寸键盘上才有的键：

上档符号

最后四行让 != 和 := 输入起来更顺手。

其他按键

当年的安装方法

以下步骤来自 V2 的 README，仅作记录。

1. 下载并安装 Karabiner-Elements。
2. 在 Safari 中打开下面的地址导入规则：

   karabiner://karabiner/assets/complex_modifications/import?url=https://raw.githubusercontent.com/Vonng/Capslock/main/mac_v2/capslock.json

   也可以把 capslock.json 复制到 ~/.config/karabiner/assets/complex_modifications/，mac_v2 目录下的 make install 做的就是这件事。
3. 在 Karabiner-Elements 中打开 Complex Modifications 标签页，点按 Add Item，再启用你需要的规则。
4. 如需更换应用或修改其他按键，编辑 ~/.config/karabiner/assets/complex_modifications/ 中导入的那份文件。

文件

V2 的全部文件都在仓库的 mac_v2/ 目录中。

与 V3 的区别

• 平面。 V2 每次只让 Hyper 与一个左侧修饰键组合，因此只有少数几个平面。V3 允许 Hyper 与四个左侧修饰键任意组合，最多可得 16 个平面。
• **改动的按键。**在 V3.1 中，F13 和 F14 改为截屏控制，不再是上一首和下一首；✱ ⌘ D 改为执行「查询」（Define），不再打开词典；聚焦搜索（Spotlight）取代了启动台。

6.2 - Mac V1

Mac V1 是 Capslock 在 Mac 上的第一个版本，需要两个工具配合：先用 Seil 把 Caps Lock 发出的键码改为 80，也就是 F19 的键码；再由 Karabiner 读取 V1 的 private.xml，在按住这个键时把它变成 Hyper（✱）。每组快捷键都是一个独立条目，可以在 Karabiner 的偏好设置中分别开启。

Caps Lock 键

导航

按住 Hyper 移动光标；再加上左侧 ⌘，就会边移动边选择。

删除

窗口与标签页

终端按键

应用

README 建议把这些换成你自己常用的应用。

功能键

全尺寸键盘上才有的键：

上档符号

鼠标

其他按键

当年的安装方法

以下步骤来自 V1 的 README，仅作记录。

1. 下载并安装 Seil。
2. 下载并安装 Karabiner。
3. 在 Seil 中勾选 Change the caps lock key，并把键码设为 80。
4. 在 Karabiner 中打开 Misc & Uninstall 标签页，点按 Open private.xml，用 V1 的private.xml 替换这个文件。mac_v1 目录下的 setup 脚本可以代劳，它会把文件复制到~/Library/Application Support/Karabiner/private.xml。
5. 回到 Change Key 标签页，点按 Reload XML，再启用你需要的条目。

文件

V1 的全部文件都在仓库的 mac_v1/ 目录中。

与 V3 的区别

• 工具。 V1 需要 Seil 和旧版 Karabiner，配置文件是 XML。从 macOS Sierra 起， Karabiner-Elements 取代了旧版 Karabiner；V2 和 V3 都是它的 JSON 规则，也不再需要 Seil。
• 轻按 Caps Lock。 V1 可以在 Escape 和切换输入法之间二选一；V3 轻按时发送 Escape。

6.3 - Windows

Capslock 始于 2013 年的 Windows，比第一个 Mac 版本早两年。这份脚本把被视为「无用键」的 Caps Lock 变成像 Ctrl、Alt 一样的功能键，与键盘上几乎所有其他键组合使用。Caps Lock 原本的大小写锁定始终保持关闭，这项功能改由 Caps Lock + ` 承担。

它的部分按键绑定与 Mac 版不同。Mac V2 的 README 提到了这一点，并说明 Windows 版已不再维护。

功能一览

README 用一张表概括了这份脚本。下表沿用这份概括，并依据脚本本身补充了细节。

运行方式

README 没有给出安装步骤。仓库中保存了这份脚本的两种形式：

• 源码 CapsLock.ahk：用 AutoHotkey 运行，采用 AutoHotkey v1 语法。
• 预编译的可执行文件 CapsLock.exe：无需安装 AutoHotkey 即可运行。

文件

Windows 版的全部文件都在仓库的 win/ 目录中。

仓库中 CapsLock.exe 的 SHA-256 为e0d6a4d2de155860aed164281ed16f5871aaca95cccc6fe1d46db2b16004cb80。