直观的图形界面
通过 Simple Modifications 面板即可完成基础按键重映射，无需编写任何代码。从 Caps Lock 改造到功能键调整，所有操作可视化完成，新手也能在五分钟内上手。
v16.3.0 现已发布 · 支持 macOS 26 Tahoe
为 macOS 而生的
为 macOS 而生的
键盘深度定制工具
Karabiner-Elements 是一款专业、稳定、开源的 macOS 键盘定制软件。重映射任意按键、构建复杂快捷键组合、为不同设备设置独立配置，让每一颗按键都按你的方式工作。
karabiner.json · 配置预览
caps_lock
→
left_control
基础映射
right_cmd
→
hyper (⌃⌥⌘⇧)
Hyper 键
fn + h/j/k/l
→
arrow keys
Vim 模式
escape
→
escape + ⌃
双 Esc 触发
tab + hold
→
launch_terminal
长按触发
Core Advantages
为什么选择 Karabiner-Elements
从基础按键重映射到复杂的条件触发规则，Karabiner-Elements 提供 macOS 上最完整、最灵活的键盘定制能力，被全球超过百万开发者与专业用户所信赖。
强大的复杂规则
Complex Modifications 引擎支持条件触发、修饰键组合、按键序列识别。可一键导入社区规则库，包括 Vim 模式、Emacs 绑定、Diamond 光标、防误触 Command+Q 等数十种预设方案。
多设备独立配置
为内置键盘、外接机械键盘、人体工学键盘分别设置不同的映射方案。连接外接键盘时可自动禁用内置键盘，避免误触；为每个设备建立独立 Profile，无缝切换工作场景。
JSON 可编程配置
所有配置以 karabiner.json 文件存储，支持版本管理与团队共享。开发者可编写任意复杂的规则脚本，通过 shell_command、set_variable、sticky_modifier 等高级特性实现极致定制。
开源透明可信
源代码完全开放在 GitHub，采用 MIT 许可证，由 pqrs-org 团队维护超过十年。所有按键事件在本地处理，不上传任何用户数据，隐私安全可审计、可验证。
EventViewer 实时调试
内置 EventViewer 工具实时显示按键事件、修饰键状态与设备信息。配置出错时可快速定位问题，是开发复杂规则不可或缺的调试利器。
Use Scenarios
真实使用场景
无论你是追求极致效率的程序员、跨应用切换的创意工作者，还是希望优化 Mac 使用体验的普通用户，Karabiner-Elements 都能为你量身打造专属键盘方案。
开发者效率提升
将 Caps Lock 改造为 Hyper 键，配合 hjkl 实现 Vim 风格的全局方向键；为 IDE、终端、浏览器分别绑定独立快捷键组合，告别键位冲突，编码效率倍增。
设计师工作流优化
为 Figma、Photoshop、Sketch 等设计软件定制专属快捷键，将常用工具切换、图层操作一键化。外接数位板时自动切换到设计专用 Profile，回到桌面恢复默认配置。
外接键盘适配
使用 Windows 布局的外接键盘时，自动将 Alt 与 Command 位置互换以匹配 Mac 习惯；为 HHKB、Realforce、客制化机械键盘分别建立专属配置文件，插拔设备时无缝切换。
防误触与安全保护
启用 Prevent unintended command-q 规则，避免误关应用；为系统级快捷键设置二次确认；将危险组合键改为需要长按触发，从根本上杜绝误操作带来的数据损失。
0
最新版本号
0
支持的 macOS 版本
0
开源免费
0
社区规则库
Configuration Example
JSON 配置一目了然
所有配置以纯 JSON 文件存储，可读性强、可版本化、可团队共享。下面是一个将 Caps Lock 改造为 Hyper 键的典型示例。
karabiner.json · Complex Modifications
{
"complex_modifications": {
"rules": [
{
"description": "Caps Lock → Hyper Key (⌃⌥⌘⇧)",
"manipulators": [
{
"type": "basic",
"from": {
"key_code": "caps_lock",
"modifiers": { "optional": ["any"] }
},
"to": [
{ "key_code": "left_shift", "modifiers": ["left_command", "left_control", "left_option"] }
],
"to_if_alone": [
{ "key_code": "escape" }
]
}
]
}
]
}
}
FAQ
常见问题解答
关于 Karabiner-Elements 的安装、使用与兼容性，这里有你最关心的答案。
Karabiner-Elements 是完全免费的开源软件，采用 MIT 许可证发布，源代码托管在 GitHub 上。任何个人或企业用户均可自由使用、修改和分发，无需付费订阅，也无任何功能限制或广告植入。项目接受社区赞助以维持持续开发，但赞助完全自愿。
完全支持。Karabiner-Elements 提供原生 Universal Binary 安装包，同时在 Apple Silicon 与 Intel 芯片的 Mac 设备上原生运行，无需 Rosetta 转译。从 M1 到最新的 M4 系列芯片均已通过完整兼容性测试，性能表现与稳定性与 Intel 平台一致。
首次启动 Karabiner-Elements 时，系统会提示授予输入监控权限（Input Monitoring）。请前往系统设置 → 隐私与安全性 → 输入监控，启用 Karabiner-Elements 与 Karabiner-EventViewer 两个应用的开关。授权完成后重启应用即可正常工作。所有按键事件仅在本地处理，不会上传到任何服务器。
配置文件位于 ~/.config/karabiner/karabiner.json。该文件包含所有按键映射规则、设备配置与 Profile 信息。备份时只需复制此文件即可；迁移到新 Mac 时，将文件放置到相同路径后重启 Karabiner-Elements 即可生效。建议将此文件纳入 dotfiles 版本管理，便于跨设备同步。
macOS 大版本升级后，输入监控权限可能需要重新授权。请前往系统设置 → 隐私与安全性 → 输入监控，先关闭再重新开启 Karabiner-Elements 的开关，然后重启应用。若问题仍未解决，建议升级到最新版本的 Karabiner-Elements，新版本通常会在 macOS 发布后短期内提供兼容性更新。
