前言
最近借助得捷的晒单活动入手了 Adafruit MacroPad RP2040，这块板子性能强劲且自带 OLED 屏幕，非常适合用来做客制化小键盘。虽然默认固件能用，但为了追求极致的自定义体验（改键、宏、灯光），我决定为它重新编译 QMK 固件，并开启 VIA 支持。
本文将带你从零开始：搭建环境 → 编译固件 → 定制 OLED 图案 → 开启 VIA 支持。
第一步：搭建 QMK 编译环境
工欲善其事，必先利其器。我们首先需要配置 QMK 的编译环境。
1.下载工具： 前往 GitHub 下载最新的 QMK MSYS 安装包（Windows 用户选择 .exe 文件）。
链接：Release 1.12.0 · qmk/qmk_distro_msys
2.初始化环境： 安装完成后打开 QMK MSYS 终端，输入以下命令并回车：
qmk setup
Tips: 第一次配置环境最好开启魔法（梯子），否则拉取依赖库的速度会非常慢 。等待进度条跑完，出现 “QMK is ready to go” 即表示环境配置完成 。
2. 创建工程与编译器优化
2.1 新建键盘配置
在你的主目录下，进入固件目录并新建一个属于你的 Keymap（配置）：
Bash
cd qmk_firmware
qmk new-keymap -kb adafruit/macropad -km jerry_macropad
这行命令的意思是基于 adafruit/macropad 模板，创建一个名为 jerry_macropad 的新配置 。