# 安装与 Hyper 基础 > 安装 Karabiner-Elements，一键导入 Capslock 规则并确认生效，再理解单击、按住、Hyper 与十六个控制平面。 --- LLMS 索引： [llms.txt](/zh/llms.txt) --- Capslock Enhancement V3 **当前版本** 面向 macOS 与 [Karabiner-Elements](https://karabiner-elements.pqrs.org/)。除此之外没有别的 东西需要安装：这套配置就是一组由 Karabiner 解释执行的复杂修饰规则，不会新增 常驻进程，也不需要在你的机器上编译任何东西。 > [!NOTE] > 本文在 2026 年 8 月使用 Karabiner-Elements 16.1.0 验证，该版本的支持范围覆盖 > Intel 与 Apple 芯片上的 macOS 13 Ventura 至 macOS 27。当前版本请以官网为准。 ## 安装 {#install} ### 安装 Karabiner-Elements {#install-karabiner} 从[官方网站](https://karabiner-elements.pqrs.org/)下载 DMG 并运行 `Karabiner-Elements.pkg`，或者直接使用 Homebrew： ```bash brew install --cask karabiner-elements ``` 打开 Karabiner-Elements Settings，按照系统设置提示，允许特权与非特权后台服务、 辅助功能、输入监控与驱动扩展。在 **Virtual Keyboard** 中选择与物理键盘一致的 布局。各项权限的作用见 [官方安装指南](https://karabiner-elements.pqrs.org/docs/getting-started/installation/)。 ### 导入规则 {#import} 打开下面这个导入链接，任意浏览器都会把它直接交给 Karabiner-Elements： 导入 Capslock Enhancement V3.1 也可以自己粘贴这个 URL： ```text karabiner://karabiner/assets/complex_modifications/import?url=https://raw.githubusercontent.com/Vonng/Capslock/main/mac_v3/capslock.json ``` 点击 **Import**，并允许浏览器打开 Karabiner-Elements。 ### 启用规则并检查 {#verify} 在 **Settings › Complex Modifications** 中启用需要的规则。十条规则彼此独立， 用不到的类目可以不启用；第一条 `CapsLock to Hyper` 是其余所有规则的前提。 随后单击 ⇪，它应当发送 ⎋；按住它再依次按 H J K L，光标随之移动。 此时你已经在零号平面上了。 > [!TIP] > 另有两条等价路径。[Karabiner 陈列馆页面](https://ke-complex-modifications.pqrs.org/#caps_lock_enhancement) > 本身就有 **Import** 按钮；完全离线安装则可以把 [`capslock.json`](https://raw.githubusercontent.com/Vonng/Capslock/main/mac_v3/capslock.json) > 放进 `~/.config/karabiner/assets/complex_modifications/`，再选择 **Add predefined rule**。如果哪个键行为不对，Karabiner-EventViewer 会显示它 > 实际发出了什么。 ## 十条规则 {#families} ![Capslock 零号控制平面](/img/karabiner/keyboard-hero.webp) {class="caps-only-light" caption="零号控制平面：单独按住 ⇪ 时的布局。它背后还有十五个由左侧修饰键选择的平面。"} ![Capslock 零号控制平面](/img/karabiner/keyboard-hero-dark.webp) {class="caps-only-dark" caption="零号控制平面：单独按住 ⇪ 时的布局。它背后还有十五个由左侧修饰键选择的平面。"} 键位图按用途着色，因此一个键的邻居就大致告诉你它做什么。整份配置由十条 Karabiner 规则组成，一类一条，可以逐条启用。 | 类目 | 颜色 | 作用 | 映射数 | | :--- | :--- | :--- | :--- | | [基础功能](#hyper) | 蓝色 | 单击 ⇪ 发送 ⎋，按住则是 ✱ Hyper，另含输入法切换 | 4 | | [导航](/zh/docs/karabiner/navigation/#navigation) | 粉色 | Vim 式移动、选择、标签页与窗口切换、指针与滚轮 | 102 | | [删除](/zh/docs/karabiner/navigation/#deletion) | 棕色 | `NM,.` 按字符、词、行删除，手不必离开核心区 | 12 | | [鼠标键](/zh/docs/karabiner/navigation/#mousekey) | 小键盘 | 把数字小键盘变成一只完整的鼠标 | 63 | | [窗口管理](/zh/docs/karabiner/workflows/#window-control) | 淡蓝 | 关闭与轮换标签页、窗口、应用与桌面；睡眠、锁屏、注销 | 19 | | [应用捷径](/zh/docs/karabiner/workflows/#applications) | 黄色 | 在三个平面上启动或切换六个应用 | 18 | | [终端控制](/zh/docs/karabiner/workflows/#terminal-control) | 绿色 | 终端信号、IDE 运行控制、Vim 与 Tmux 前缀、Codex 与 Claude | 10 | | [剪贴板](/zh/docs/karabiner/workflows/#clipboard) | 紫色 | 6–0 上的五个额外文本剪贴板 | 10 | | [字符变换](/zh/docs/karabiner/workflows/#shifter) | 橙色 | 把括号与代码标点挪到核心区附近 | 16 | | [功能键](/zh/docs/karabiner/reference/#functional) | 青色 | 截图、媒体、亮度、键盘背光与音量 | 28 | {.matrix .wide caption="capslock.json 中的十条规则，以及各自承载的映射数量"} > [!TIP] > [配置器](/zh/docs/karabiner/configurator/)读取的是同一份 V3 JSON，是检查任意 > 控制平面按键、定制应用启动快捷键最快的方式，并且可以导出一份可直接导入的配置。 ## 单击、按住与 Hyper {#hyper} Caps Lock 现在有两种永不冲突的行为，因为一种在松开时判定，另一种在按住期间生效。 | 操作 | 输出 | 用途 | | :--- | :--- | :--- | | 单击 ⇪ | ⎋ Escape | 双手不离开核心区即可发送 Escape | | 按住 ⇪ | ✱ Hyper | 进入零号控制平面 | | ✱ + ⎋ | ⇪ Caps Lock | 切换原始大写锁定状态 | | ✱ + ␣ | ⌃ + ␣ | 切换输入法 | | ✱ + ⌘ + ␣ | ⌃ + ⌘ + ␣ | 打开表情与符号面板 | {.matrix .wide caption="大写锁定原本的能力，全都还在一个组合键之内"} ✱ 并不是某种私有信号。Karabiner 把按住的 Caps Lock 改写成同时按下 **右侧**全部四个修饰键 ⌘ + ⌥ + ⌃ + ⇧。这带来两个值得理解的 结果： - **其他软件收到的仍然是普通组合键。** Alfred、Moom、Magnet、Raycast 以及各类 IDE 收到的是 ⌃ + ⌥ + ⇧ + ⌘ 加一个字母，可以像绑定其他快捷键 一样绑定它。 - **规则没有占用的键会原样透传。** ✱ + A 之所以没有自己的 规则，正是为了把它让给窗口管理器。任何你想交给其他应用的键都可以照此办理。 ## 十六个控制平面 {#control-planes} Hyper 保持按下时，四个**左侧**修饰键充当四个二进制开关。把它们当成四个比特位 读，就得到 0–15 号平面： ⌘ = 1 · ⌥ = 2 · ⌃ = 4 · ⇧ = 8。 | 平面 | 左侧修饰键 | 映射数 | 承载内容 | | :--- | :--- | :--- | :--- | | 0 | ✱ | 89 | 日常层：移动、删除、应用、终端、符号 | | 1 | ✱ + ⌘ | 59 | 选择、次选应用、剪贴板复制 | | 2 | ✱ + ⌥ | 38 | 指针移动与第三组应用 | | 3 | ✱ + ⌘ + ⌥ | 8 | 按词、按段选择 | | 4 | ✱ + ⌃ | 12 | 桌面与窗口管理 | | 5 | ✱ + ⌘ + ⌃ | — | 空闲 | | 6 | ✱ + ⌥ + ⌃ | — | 空闲 | | 7 | ✱ + ⌘ + ⌥ + ⌃ | — | 空闲 | | 8 | ✱ + ⇧ | 25 | 应用、窗口与标签页切换 | | 9 | ✱ + ⌘ + ⇧ | 21 | 加速滚轮 | | 10 | ✱ + ⌥ + ⇧ | 21 | 加速指针 | | 11 | ✱ + ⌘ + ⌥ + ⇧ | — | 空闲 | | 12 | ✱ + ⌃ + ⇧ | 9 | 滚轮 | | 13 | ✱ + ⌘ + ⌃ + ⇧ | — | 空闲 | | 14 | ✱ + ⌥ + ⌃ + ⇧ | — | 空闲 | | 15 | ✱ + ⌘ + ⌥ + ⌃ + ⇧ | — | 空闲 | {.matrix .wide caption="V3.1 的全部十六个平面、各自的映射数量，以及它遵循的主题"} 九个平面已被使用，另外七个是留给你自己规则的空间。打开 [配置器](/zh/docs/karabiner/configurator/)可以交互式浏览同样的十六行，并查看 所选平面上每个键的实际行为。 平面的划分并不随意。在整份配置里，同一个修饰键始终保持同一种含义，这也是这套 布局可以「学一次」而不是「逐键背诵」的原因： | 修饰键 | 一以贯之的含义 | | :--- | :--- | | ⌘ | 加强当前动作：从移动变成选择，从粘贴变成复制，切到第二个应用 | | ⌥ | 离开文本世界：指针、滚轮、第三个应用 | | ⌃ | 与窗口服务器对话：桌面、调度中心、屏幕状态 | | ⇧ | 切换容器：应用、窗口、标签页；或者给指针动作加速 | ## 兼容性 {#compatibility} - 这套布局以 **ANSI** 键盘为蓝本，内置键盘与外接键盘表现一致。ISO 布局同样可用， 只是物理位置不同的那两个键可能落在意料之外的地方。 - [鼠标键](/zh/docs/karabiner/navigation/#mousekey)需要一块数字小键盘，其余功能在 87 键键盘上都能用。 - 更旧的 macOS 需要归档版本的 Karabiner-Elements，不在本指南覆盖范围内。 > [!WARNING] > macOS 自己也保留了少量全局组合键，最常见的冲突是 > ⌘ + ⌥ + ⌃ + ⇧ + \.，它可能唤起系统诊断对话框，参见 [Issue #30](https://github.com/Vonng/Capslock/issues/30)。如果与你使用的 > 平面冲突，请重新映射该系统快捷键。 ## 下一步 {#next} 继续阅读[导航、删除与鼠标控制](/zh/docs/karabiner/navigation/)。 --- 反链： - [Karabiner 版](/zh/docs/karabiner/) - [早期版本](/zh/docs/karabiner/archive/) - [Mac V1](/zh/docs/karabiner/archive/mac-v1/) - [Mac V2](/zh/docs/karabiner/archive/mac-v2/) - [配置器](/zh/docs/karabiner/configurator/) - [下载](/zh/download/)