Karabiner-Elements

Karabiner-Elements 是一款适用于 macOS 的免费开源键盘自定义工具，由 Fumihiko Takayama（tekezo/pqrs.org）及贡献者维护。它适用于开发者、键盘爱好者，以及需要针对特定设备或应用设置输入行为的用户。

功能

• 在图形化“设置”应用中创建简单的按键映射。
• 导入社区提供的复杂修改规则，或自行编写 JSON/JavaScript 规则。
• 自定义功能键、修饰键、同时按键及条件操作。
• 选择要修改的键盘或指点设备，并使用独立配置文件。
• 使用 Karabiner-EventViewer 检查输入事件和设备标识符。
• 使用受支持的鼠标按键和 MultitouchExtension 功能及命令行控制。

安装与启用

使用 brew install --cask karabiner-elements 安装，或打开官方 DMG 并运行其中的 PKG 安装程序。此操作会安装后台服务和虚拟键盘/鼠标驱动；安装程序需要管理员授权，特权服务也需要获准运行。打开 Karabiner-Elements 设置，并按照 macOS“系统设置”中的提示完成设置：允许特权/非特权后台服务，根据需要授予“辅助功能”和“输入监控”权限，并允许驱动扩展。当前指南指出，通常获准使用“辅助功能”也会同时涵盖“输入监控”。选择与实体键盘相匹配的虚拟键盘布局，然后添加简单映射并进行测试。

要求与平台

当前16.3.0版本支持 macOS13 Ventura 至27 Golden Gate。macOS13–26上的 Intel 和 Apple Silicon Mac 均受支持；仓库列出的 Apple Silicon 支持 macOS27。较旧系统需要使用供应商发布的旧版本，例如 macOS11–12 可使用14.13.0；不要仅因旧版本曾支持你的 Mac 就安装当前软件包。本工具仅适用于 macOS；目前没有已确认的官方 Windows、Linux、iOS 或 Android 版本。引用的指南未公布最低内存和安装存储空间要求。官方16.3.0 DMG 大小为42,388,528字节，与安装后的占用空间不同。

记录的 cask 会安装 PKG，且未声明其他公式依赖项或明确的 cask 冲突。实际执行按键重映射需要其虚拟 HID 驱动和后台服务。其他会更改键盘输入的工具可能需要配置兼容性；请参阅供应商关于 Logitech Logi Options+ Fn 键的指南，不要假定所有输入工具都能协同工作。源代码仓库中的构建工具依赖项用于编译，并非已签名下载软件包的前置要求。

从15.9.0或更早版本升级时，自动启动服务功能会被禁用；升级后打开 Karabiner-Elements.app 可重新启用该功能。请使用文档说明的卸载程序，因为部分组件位于应用程序包之外。

费用、账户与许可

在本地进行键盘重映射无需服务账户或订阅。该项目免费，并接受自愿赞助/捐赠。项目主体采用公共领域/Unlicense 许可；捆绑的第三方组件仍遵循各自的许可。导入的规则可能会执行操作，因此请仔细检查准备启用的规则。

来源：官方网站、安装指南、代码仓库、发行说明、许可证。