手把手搞定 QMK从编译到刷写给键盘换上自己写的逻辑【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware你手上的键盘其实还能改——把 Enter 兼当 Delete、开会时一键切到快捷键布局、敲一下自动输出一整段话。这些事都不需要动电烙铁只需要改写芯片里跑的那套逻辑。QMK 就是干这件事最主流的开源项目它是一套 QMK固件你把它编译好、刷进自定义键盘每个键位的行为就归你说了算了。先说结论刷完之后你能改到什么程度别被固件两个字吓到你最终能拿到的结果是这四样任意键位重定义哪个键干什么全由你在代码里排Enter 兼任 Delete 只是最基础的操作同一个键换个场景换个功能这叫层主层打字、副层放截图/音量/媒体键一键出整段文本宏功能绑定一个 ID按一下键盘替你敲完灯效随你调支持 RGB 的板子可以改颜色和呼吸节奏整条链路里唯一有点仪式感的环节是进入 DFU 刷写态改键位本身更多是复制粘贴和改一个单词。30 秒认识 QMK固件是什么可以把 QMK 理解为跑在键盘小芯片里的翻译程序你手指按下的只是一个网格状开关阵列里的某个交点它负责读出行列、判定哪个键被按再翻译成电脑认识的字符或指令。仓库本身不是一整坨代码而是分得挺清楚的四块知道它们在哪后面翻文档会轻松很多keyboards/每个型号的档案矩阵怎么排、用什么主控、灯在哪都写在这里quantum/核心功能实现键码、层、宏这些机制的源码都在这users/放你个人私有配置的地方docs/官方文档本文引用的每份说明都能在这里找到动手前准备装好工具、拉下源码第一步装 QMK CLI编译和刷写都靠一个叫 QMK CLI 的命令行工具。官方推荐用一键安装脚本把它和工具链、刷写工具一起装好脚本原文在 CLI 文档 里照着敲一行即可。装完跑一下qmk version能打印出版本号就说明环境通了。第二步把固件源码拉到本地git clone https://gitcode.com/GitHub_Trending/qm/qmk_firmware克隆进目录后用ls看一眼能列出 keyboards、quantum、docs 这些顶层目录说明源码拿全了。第三步把自己的板子和 keymap 设成默认值qmk config user.keyboardplanck/rev5 qmk config user.keymapcustom这两条是把我用哪块板子、用哪个布局写进配置。做完后跑qmk config user.keyboard回显一遍看到刚才填的值就对了。之后编译、刷写都能省掉一堆-kb、-km参数。三步出固件new-keymap、改键、编译刷写创建你自己的 keymapqmk new-keymap -kb planck/rev5这一步从默认布局克隆出一份属于你的 keymap生成在keyboards/planck/keymaps/你的用户名/下包含三个文件keymap.c键位定义你 90% 的时间看它、config.h功能开关、rules.mk编译选项。改键位只动 LAYOUT 段落用编辑器打开keymap.c找到LAYOUT(...)那一大段每个位置对应一个键。想把删除键挪个位置就直接替换对应格子里的键码const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] { [0] LAYOUT( KC_ESC, KC_1, KC_2, KC_3, KC_4, KC_5, KC_TAB, KC_Q, KC_W, KC_E, KC_R, KC_T, ... KC_LCTL, KC_LALT, KC_LGUI, KC_SPC, KC_BSPC, KC_RALT, KC_RCTL, TG(1) ) };规矩只有一条只换单词逗号和括号别碰。最后一行顺手放了一个TG(1)意思是这格绑定第 1 层的开关。编译与刷写qmk compile qmk flashqmk compile完成后仓库根目录会多出一个形如planck_custom.hex的文件命名规律是板子_keymap看到它就说明编译成功。qmk flash会把固件送进键盘——但前提是键盘已经躺在 DFU 刷写态里怎么进见下一节。刷完键盘会自动重启按你改过的那个键验证一下有新功能就算闭环了。刷不进去先查这三处我头一次刷就卡在这一步板子压根没进 DFU工具空等半天。按命中率从高到低排DFU 没进去最稳的办法是短按 PCB 上的 RESET 小按钮没有按钮的板子通常是按住某个指定键再插 USB各板子的具体姿势在刷写指南docs/flashing.md里都有写。进对了系统会识别出一个新设备刷写工具才找得到它编译就报错八成是keymap.c里逗号或括号没对齐。别自己猜直接看编译器指出的行号数一下那一行和相邻行的键码个数是否一致对照编译 FAQdocs/faq_build.md排查刷成功了但键没反应优先怀疑层没切对或键码拼写错比如把KC_DEL写成KC_DELL。先把你改的键临时绑成KC_F13这种不常用的键测一下能按出来就说明映射本身没问题再回头查层逻辑更多线索见docs/faq_debug.md继续深挖三个越玩越上头的方向层MO(1)是按住才切到 1 层、松开回主层TG(1)按一下锁在 1 层再按回来TO(2)直接跳到 2 层不弹回。三种用法直接写进 keymap 就能用细节在层功能文档docs/feature_layers.md宏给某个键绑一个宏 ID然后在keymap.c里实现action_get_macro函数按下它就能替你连敲一串字符甚至整段字符串模板写法参考宏文档docs/feature_macros.mdRGB 灯效在rules.mk里加一行RGBLIGHT_ENABLE yes再在keymap.c的keyboard_post_init_user函数里调rgblight_enable()等接口就能设颜色、亮度、呼吸模式资源一站式导航正文提到的文档全部集中在仓库里点着就能跳官方文档首页QMK CLI 安装与命令说明完整命令清单全部配置项说明键盘定义目录QMK 核心源码基础键码速查量子键码层/宏等扩展层功能文档宏功能文档刷写指南含各板 DFU 方法编译 FAQ调试 FAQ新手环境搭建【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
手把手搞定 QMK：从编译到刷写，给键盘换上自己写的逻辑
手把手搞定 QMK从编译到刷写给键盘换上自己写的逻辑【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware你手上的键盘其实还能改——把 Enter 兼当 Delete、开会时一键切到快捷键布局、敲一下自动输出一整段话。这些事都不需要动电烙铁只需要改写芯片里跑的那套逻辑。QMK 就是干这件事最主流的开源项目它是一套 QMK固件你把它编译好、刷进自定义键盘每个键位的行为就归你说了算了。先说结论刷完之后你能改到什么程度别被固件两个字吓到你最终能拿到的结果是这四样任意键位重定义哪个键干什么全由你在代码里排Enter 兼任 Delete 只是最基础的操作同一个键换个场景换个功能这叫层主层打字、副层放截图/音量/媒体键一键出整段文本宏功能绑定一个 ID按一下键盘替你敲完灯效随你调支持 RGB 的板子可以改颜色和呼吸节奏整条链路里唯一有点仪式感的环节是进入 DFU 刷写态改键位本身更多是复制粘贴和改一个单词。30 秒认识 QMK固件是什么可以把 QMK 理解为跑在键盘小芯片里的翻译程序你手指按下的只是一个网格状开关阵列里的某个交点它负责读出行列、判定哪个键被按再翻译成电脑认识的字符或指令。仓库本身不是一整坨代码而是分得挺清楚的四块知道它们在哪后面翻文档会轻松很多keyboards/每个型号的档案矩阵怎么排、用什么主控、灯在哪都写在这里quantum/核心功能实现键码、层、宏这些机制的源码都在这users/放你个人私有配置的地方docs/官方文档本文引用的每份说明都能在这里找到动手前准备装好工具、拉下源码第一步装 QMK CLI编译和刷写都靠一个叫 QMK CLI 的命令行工具。官方推荐用一键安装脚本把它和工具链、刷写工具一起装好脚本原文在 CLI 文档 里照着敲一行即可。装完跑一下qmk version能打印出版本号就说明环境通了。第二步把固件源码拉到本地git clone https://gitcode.com/GitHub_Trending/qm/qmk_firmware克隆进目录后用ls看一眼能列出 keyboards、quantum、docs 这些顶层目录说明源码拿全了。第三步把自己的板子和 keymap 设成默认值qmk config user.keyboardplanck/rev5 qmk config user.keymapcustom这两条是把我用哪块板子、用哪个布局写进配置。做完后跑qmk config user.keyboard回显一遍看到刚才填的值就对了。之后编译、刷写都能省掉一堆-kb、-km参数。三步出固件new-keymap、改键、编译刷写创建你自己的 keymapqmk new-keymap -kb planck/rev5这一步从默认布局克隆出一份属于你的 keymap生成在keyboards/planck/keymaps/你的用户名/下包含三个文件keymap.c键位定义你 90% 的时间看它、config.h功能开关、rules.mk编译选项。改键位只动 LAYOUT 段落用编辑器打开keymap.c找到LAYOUT(...)那一大段每个位置对应一个键。想把删除键挪个位置就直接替换对应格子里的键码const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] { [0] LAYOUT( KC_ESC, KC_1, KC_2, KC_3, KC_4, KC_5, KC_TAB, KC_Q, KC_W, KC_E, KC_R, KC_T, ... KC_LCTL, KC_LALT, KC_LGUI, KC_SPC, KC_BSPC, KC_RALT, KC_RCTL, TG(1) ) };规矩只有一条只换单词逗号和括号别碰。最后一行顺手放了一个TG(1)意思是这格绑定第 1 层的开关。编译与刷写qmk compile qmk flashqmk compile完成后仓库根目录会多出一个形如planck_custom.hex的文件命名规律是板子_keymap看到它就说明编译成功。qmk flash会把固件送进键盘——但前提是键盘已经躺在 DFU 刷写态里怎么进见下一节。刷完键盘会自动重启按你改过的那个键验证一下有新功能就算闭环了。刷不进去先查这三处我头一次刷就卡在这一步板子压根没进 DFU工具空等半天。按命中率从高到低排DFU 没进去最稳的办法是短按 PCB 上的 RESET 小按钮没有按钮的板子通常是按住某个指定键再插 USB各板子的具体姿势在刷写指南docs/flashing.md里都有写。进对了系统会识别出一个新设备刷写工具才找得到它编译就报错八成是keymap.c里逗号或括号没对齐。别自己猜直接看编译器指出的行号数一下那一行和相邻行的键码个数是否一致对照编译 FAQdocs/faq_build.md排查刷成功了但键没反应优先怀疑层没切对或键码拼写错比如把KC_DEL写成KC_DELL。先把你改的键临时绑成KC_F13这种不常用的键测一下能按出来就说明映射本身没问题再回头查层逻辑更多线索见docs/faq_debug.md继续深挖三个越玩越上头的方向层MO(1)是按住才切到 1 层、松开回主层TG(1)按一下锁在 1 层再按回来TO(2)直接跳到 2 层不弹回。三种用法直接写进 keymap 就能用细节在层功能文档docs/feature_layers.md宏给某个键绑一个宏 ID然后在keymap.c里实现action_get_macro函数按下它就能替你连敲一串字符甚至整段字符串模板写法参考宏文档docs/feature_macros.mdRGB 灯效在rules.mk里加一行RGBLIGHT_ENABLE yes再在keymap.c的keyboard_post_init_user函数里调rgblight_enable()等接口就能设颜色、亮度、呼吸模式资源一站式导航正文提到的文档全部集中在仓库里点着就能跳官方文档首页QMK CLI 安装与命令说明完整命令清单全部配置项说明键盘定义目录QMK 核心源码基础键码速查量子键码层/宏等扩展层功能文档宏功能文档刷写指南含各板 DFU 方法编译 FAQ调试 FAQ新手环境搭建【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
