jtroo/kanata

这是什么？

核心功能

• 01可在任意键盘上为按键设置多个功能层
• 02支持轻按/长按等高级按键行为
• 03支持 Unicode 输出以及动态和静态宏
• 04支持类 Vim 的前导键序列
• 05配置文件修改后可实时重载
• 06可选的 TCP 服务器，便于与其他程序集成

适用场景

• 在笔记本键盘上，把方向键或数字小键盘放到主排键位的另一层
• 在普通办公键盘上实现类似 QMK 的键位布局
• 配合社区工具按应用自动切换层
• 在 Linux、macOS 和 Windows 之间共用同一套个人键位配置

快速上手

1. 1

   使用 Cargo 安装 kanata

   cargo install kanata
2. 2

   使用你的配置文件运行 kanata（Linux 和 macOS 上可能需要 sudo）

   kanata --cfg <your_configuration_file>

使用前须知

• !kanata 不会在后台运行，因此启动它的窗口必须保持打开。
• !在 Linux 和 macOS 上通常需要 sudo 才能拦截键盘，macOS 还需要安装 Karabiner 驱动。
• !它采用 LGPL-3.0 许可证，这是一种 Copyleft 许可证。

收录于专题

标签

常见问题

kanata 是什么？

跨平台键盘重映射工具，支持 Linux、macOS 和 Windows，可为任意键盘添加多层映射、长按/轻按、宏等功能。 Kanata 是一款跨平台的软件键盘重映射工具，支持 Linux、macOS 和 Windows。它可以为任意按键设置多个功能层，类似 Shift 切换大小写的思路，让原本位于主排附近的按键在另一层上使用，无需更换硬件。

kanata 可以免费使用吗？用的什么许可证？

kanata 以 LGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

kanata 还在维护吗？

活跃维护中。kanata 最近一次提交是在 2026年11月2日。

kanata 适合用来做什么？

在笔记本键盘上，把方向键或数字小键盘放到主排键位的另一层 在普通办公键盘上实现类似 QMK 的键位布局 配合社区工具按应用自动切换层 在 Linux、macOS 和 Windows 之间共用同一套个人键位配置

kanata 怎么安装和运行？

使用 Cargo 安装 kanata: cargo install kanata 使用你的配置文件运行 kanata（Linux 和 macOS 上可能需要 sudo）: kanata --cfg <your_configuration_file>

在哪里获取 kanata？

源代码和安装说明在 GitHub 上：https://github.com/jtroo/kanata