ZMK 键盘固件 3 步烧录指南：普通键盘如何变身无线分体
【免费下载链接】zmkZMK Firmware Repository项目地址: https://gitcode.com/gh_mirrors/zm/zmk
如果你嫌键盘原厂固件只有一层键位，想加图层、换布局，又不知道从哪下手，ZMK 键盘固件值得看一眼。它基于 Zephyr 实时系统，MIT 协议开源，兼容 nRF52840、RP2040 等常见芯片。刷上之后，普通键盘也能做蓝牙多设备切换和左右无线分体。
⚙️ 先确认：你的需求 ZMK 接得住吗
刷之前先对照四件事：
- 主控芯片在支持列表里：nRF52840、nRF52833、RP2040、STM32 等
- 蓝牙多设备：最多记住 3 台，一个键切换，不用每台重新配对
- 无线分体：两半通过 BLE 互联，打字延迟低到无感
- 暂时没有硬件：支持原生模拟，可以先在电脑上验证键位逻辑
第一条决定你能不能刷，后三条决定能玩到什么程度，对号入座再动手。
🔧 三步完成 ZMK 固件烧录
- 取源码：执行
git clone https://gitcode.com/gh_mirrors/zm/zmk拉取仓库 - 对主控：
app/boards里的 board 与主控一一对应，比如 Seeed XIAO BLE、Adafruit QT Py、Pro Micro 互联板 - 刷 shield：用
zmk flash指定 board 和 shield，shield 是量产键盘的现成键位方案
如果你的键盘在app/boards/shields目录里，直接用它自带的 shield，连键位都不用改。
图层切换怎么设置：ZMK 最核心的配置
键位文件分多层叠加：上层键位压住下层，没写的位置用透明键透到下一层。
一颗键能绑的行为不止普通快捷键：
- MO/TO/LT：瞬时切换、跳转、保持-轻点，一鍵两用
- 点舞：轻点一次和两次的动作不同
- 组合键、宏、粘性键、鼠标键模拟、编码器都有现成行为
- 参数细节见图层与行为配置说明
不想写配置：用 ZMK Studio 图形化编辑
不熟配置文件就用 ZMK Studio：USB 连上键盘，浏览器打开，点选按键、切换图层，一键保存回键盘。
简单改布局用图形界面就够；需要宏这类行为时，再回配置文件加。
三个真实用法，对应三块基础功能
- 办公党：2 台电脑加 1 台平板，一个键切换焦点，不用回系统重连
- 长文写作者：分体两半减少手腕移动，常用短语绑到宏上
- 学生：给旧 XIAO 主控刷固件，淘汰键盘也能用图层
分别对应蓝牙多设备、无线分体、图层三项基础功能，按需启用即可。
卡住了去哪里找答案
- 先读ZMK 入门文档，覆盖环境配置到烧录的完整流程
app/tests目录给每种行为配了按键序列测试，对照输出能定位是哪一步不对
下一步建议：先用一个确认能用的 shield 完成首次烧录；键位不合手再改 shield 目录键位文件里的图层，别动硬件配置。
【免费下载链接】zmkZMK Firmware Repository项目地址: https://gitcode.com/gh_mirrors/zm/zmk
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
