QMK术语速查：从萌新到高手的必备词典
项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware 你是否也曾在配置键盘时被"图层""宏命令""Tap-Hold"这些术语搞得晕头转向？作为全球最流行的开源键盘固件，QMK拥有丰富的功能生态，但专业术语常常成为新手入门的拦路虎。本文整理了50+核心术语，搭配官方文档链接和实操示例，让你7分钟快速掌握QMK精髓，轻松定制专属键盘体验。
基础概念篇
Firmware（固件）
控制键盘微控制器(MCU)的底层软件，相当于键盘的"操作系统"。QMK固件通过Makefile构建系统编译生成，存放在键盘主控芯片的存储空间中。
Keymap（键位图）
定义键盘按键功能的配置文件，是用户与QMK交互的主要方式。每个键盘型号都有独立的键位图层目录，例如keyboards/handwired/目录包含各种手工焊接键盘的默认键位图。
MCU（微控制单元）
键盘的"大脑"，常见型号包括Atmel的AVR系列和ARM架构的STM32系列。QMK支持的具体型号可参考docs/compatible_microcontrollers.md。
核心功能篇
Layer（图层）
QMK最强大的功能之一，允许单个按键在不同"图层"中实现不同功能。通过切换图层，60%键盘也能拥有全尺寸键盘的功能。官方图层文档docs/feature_layers.md详细介绍了图层切换的12种方式，包括：
- 临时切换（按住Fn键）
- 锁定切换（按一次切换，再按返回）
- 一键切换（单次触发永久切换）
Macro（宏命令）
将一系列按键操作录制为单个按键触发的自动化指令。例如设置一个宏实现"Ctrl+C"复制功能，只需按下一个按键即可完成组合键操作。QMK支持两种宏定义方式：
- 基础宏：在keymap.c中通过
MACRO()函数定义 - 动态宏：通过features/dynamic_macros实现键盘端录制
Tap-Hold（点按与长按）
让单个按键根据按压时长实现不同功能。例如将CapsLock键设置为：短按触发Esc，长按触发Ctrl。这种设计极大提高了键盘空间利用率，具体实现可参考docs/tap_hold.md中的配置示例：
// 短按Ctrl，长按ESC
#define CTL_ESC LCTL_T(KC_ESC)
硬件相关篇
Matrix（矩阵扫描）
键盘按键的底层工作原理，通过行(ROW)列(COL)交叉检测按键状态。QMK采用高效的扫描算法，支持最大256x256的矩阵规模。矩阵布线示意图可参考docs/how_a_matrix_works.md中的详细说明。
NKRO（全键无冲）
N-Key Rollover的缩写，指键盘能够同时识别任意数量按键的按下状态。QMK默认启用USB全键无冲功能，在docs/usb_nkro.txt中有技术实现细节。
Bootloader（引导程序）
位于MCU中的专用程序，负责固件更新功能。不同芯片有不同的引导程序进入方式，常见的有：
- AVR芯片：通过ISP接口或特定按键组合
- ARM芯片：DFU模式或BOOT0引脚
开发工具篇
QMK Configurator
官方提供的可视化配置工具，无需编程知识即可定制键位。在线版可通过官方网站访问，本地版源码位于项目仓库中。配置流程可参考docs/configurator_step_by_step.md中的图文教程。
Make（构建工具）
QMK的编译系统核心，通过Makefile定义的规则将源码编译为可烧录文件。常用命令：
# 编译指定键盘的默认键位
make <keyboard>:<keymap>
# 编译并自动烧录
make <keyboard>:<keymap>:flash
hid_listen
接收键盘调试信息的工具，可捕获QMK固件输出的调试日志。使用方法参考docs/faq_debug.md，典型应用场景包括：
- 调试按键扫描问题
- 监控图层切换状态
- 跟踪宏命令执行过程
进阶技术篇
Unicode（万国码输入）
支持直接输入各种语言字符和特殊符号的功能。通过组合键触发 unicode 输入模式，然后输入字符编码实现。QMK提供三种 unicode 实现方式，详细配置见docs/features/unicode.md。
Tap Dance（连击）
根据按键连击次数触发不同功能，例如：
- 按1次：普通Enter
- 按2次：发送"Enter+Shift"
- 按3次：启动特定程序
具体实现可参考docs/features/tap_dance.md中的示例代码。
学习资源导航
官方文档
社区资源
- 键盘示例：keyboards/目录下包含500+种键盘的参考实现
- 用户配置：layouts/community/汇集了社区贡献的键位方案
- 常见问题：docs/faq_general.md解答90%的新手疑问
掌握这些术语后，你已经超越了80%的QMK用户。想要深入定制？推荐从修改users/_example/目录下的示例用户配置开始，逐步构建自己的键盘生态系统。遇到问题时，QMK社区论坛和Discord群组有数千名开发者随时提供帮助。现在就打开你的编辑器，开始打造独一无二的键盘体验吧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
