自编译QMK入门篇——开发环境搭建与编译

前言

之前写过使用kbfirmware编译QMK的教程，一些人不满足于简单的QMK固件，总想加个蓝牙或者RGB背光灯之类的特性。这次开个系列详细说说怎么编译出功能复杂一点的QMK固件。教程会从开发环境搭建，配列修改，蓝牙或背光等附加特性都详细说说，喜欢的可以关注一下。

kbfirmware使用教程——以制作小太刀TEX Kodachi键盘为例前言这些天有值友在之前的制作键盘的原创中询问kbfirmware的详细使用教程，趁着最近在自制小太刀TEXKodachi小红点机械键盘，就制作个详细kbfirmware使用教程好了。PS：docs.qmk.fm有QMK固件的详细设置介绍，有兴趣的可以自己去看。教程小太刀Kodachi这款红点机械键盘qianseyue| 赞68 评论65 收藏303查看详情

搭建

自己编译QMK固件，需要搭建AVR或ARM的开发环境。如果是使用linux或mac的或比较简单，安装使用Git即可。如果是Windows系统，则会复杂。

Windows系统推荐使用的编译器是MSYS2开发环境，官网上能免费下载安装包。

MSYS2的安装没有什么需要注意的地方，一路next即可。

运行MSYS的第一步是先运行“pacman -Syu”命令更新一下数据库。

期间会有个安装确认，无脑Yes就行了。

有时候可能是墙的问题，无法成功更新。

如果运行“pacman -Syu”命令出错，可以试一下“pacman -Su”命令。

期间会有个安装确认，也是无脑Yes就行了。

更新完成后，需要重启一下MSYS程序。

使用“pacman -S git”命令，安装git。

至此基本的QMK固件编译环境就搭建好了。

简单编译

开发环境构建完成后，还要下载QMK的源码。在gayhub的QMK项目的页面上，可以下载到QMK的源码。下载zip包后，解压到程序。

也可以直接使用git，通过命令git clone --recurse-submodules https://github.com/qmk/qmk_firmware.git 实现。

下载完成后，使用cd加源码所在文件夹的命令进入QMK的源码文件夹，例如我的在C根目录下，文件夹名字为，命令是”|C|qmk_firmware“ （|是斜杠）。

接着需要使用命令 util/msys2_install.sh ，安装一些QMK所必须要的驱动程序。

为了省事就选择all，安装大概2小时。简单快速配置的话，选择2至5的驱动，大概十多分钟可以完成。安装过程更多是和配置以及网速有关，过程中的确认全部是无脑Y即可。

驱动等配置完成，可以直接输入make命令编译出默认的QMK固件，其格式是“make 键盘名字:配列名字”。

后记

之前有值友问kbfirmware下载的zip文件是怎么使用的，下载的zip压缩包是源码文件压缩包，可以使用构建的开发环境进行编译。有些人会使用kbfirmware进行基本的配置，然后再在MSYS开发环境之中添加特性，算是一种简便的方法。