矩阵键盘是嵌入式输入里最经典的方案:16 个按键只吃 8 个 GPIO,一张薄膜键盘十几块钱,配上 Keypad 库十几行代码就能跑。这篇把 4x4 矩阵键盘接 Arduino 的完整链路理一遍——行列扫描原理、接线、装库、读键,再到把按键序列攒成密码验证。写之前对照了 lastminuteengineers 和 ArduinoGetStarted 两篇教程,加上 Keypad 库的 GitHub 仓库,代码原样搬运,可直接照抄复现。

16个键只占8个脚:矩阵扫描是怎么回事
先解决新手最容易懵的问题:16 个按键,为什么只用 8 根线?把 16 个键排成 4 行 4 列,每个键落在某一行与某一列的交叉点上,行线 4 根、列线 4 根,一共 8 根线引出来——这就是"矩阵"的含义。要是每个键单独接线,16 个键得吃掉 16 个 GPIO,UNO 直接不够分。
扫描逻辑不复杂:列线轮流拉低,行线作输入读取。某根列线为低时按下按键,对应行线就会被读到低电平,行列坐标一交叉,键位就定了。8 根线撑 16 个键,4x3、3x4 同理;照这个思路扩到 8x8,64 个键也只要 16 根线。省 IO 的代价是 CPU 要不停轮询,好在 Keypad 库把这件事整个包了。


引脚顺序要看清:薄膜排线从左到右一般是 R1、R2、R3、R4、C1、C2、C3、C4,但不同厂家排序有差异。接错的症状很典型——按一个键,串口吐出另一个键的字符。遇到这种情况别急着怀疑代码,先把排线和引脚映射表对着实物核一遍。
接线与Keypad库安装
按 ArduinoGetStarted 的接线图来:行线 R1-R4 接数字口 9、8、7、6,列线 C1-C4 接 5、4、3、2。引脚可以换,代码里两组数组跟着改就行,但行列对应关系不能乱。

库用 Mark Stanley 和 Alexander Brevig 维护的 Keypad 库,写这篇时库管理器里的最新版本是 3.1.1,IDE 的库管理器里搜 Keypad 直接装。这个库是从 Arduino Playground 的老页面迁到 GitHub 的(仓库 Chris--A/Keypad),装完建议先跑 examples 里的 HelloKeypad,能出键值说明环境和接线都没问题。
第一个程序:把按键读进串口
下面是 lastminuteengineers 教程里的 4x4 读键例程,逐字符原样搬运。头文件用引号形式书写,与尖括号写法在 Arduino 工具链下对库搜索路径等价,不影响编译。
#include "Keypad.h"
const byte ROWS = 4; //four rows
const byte COLS = 4; //four columns
char keys[ROWS][COLS] = {
{ '1', '2', '3', 'A' },
{ '4', '5', '6', 'B' },
{ '7', '8', '9', 'C' },
{ '*', '0', '#', 'D' }
};
byte rowPins[ROWS] = { 9, 8, 7, 6 }; //connect to the row pinouts of the keypad
byte colPins[COLS] = { 5, 4, 3, 2 }; //connect to the column pinouts of the keypad
//Create an object of keypad
Keypad keypad = Keypad(makeKeymap(keys), rowPins, colPins, ROWS, COLS);
void setup() {
Serial.begin(9600);
}
void loop() {
char key = keypad.getKey(); // Read the key
// Print if key pressed
if (key) {
Serial.print("Key Pressed : ");
Serial.println(key);
}
}烧录后打开串口监视器,波特率 9600,每按一个键就回显一行 Key Pressed。getKey() 是非阻塞的:没有按键时返回 0,loop 照常转,所以可以和其他任务混在同一个循环里跑。

多说一句库替你干了什么:轮询扫描、消抖、按键状态机都在 Keypad 类内部完成,3.0 之后的版本还支持多键同时检测,走 getKeys() 配事件回调。教程场景用 getKey() 就够了。
从读键到密码验证
读键只是半截活,密码验证的本质是把按键序列攒成字符串去比对。ArduinoGetStarted 的例程思路很清晰:星号键清空输入,井号键触发比对,其余字符依次追加进 input_password,井号按下时和预设密码比对并给出结论。例程原样搬运,注意它的 keymap 是 4x3 布局——换 4x4 键盘时,把 keymap 和两组引脚数组换成上一节 4x4 的定义即可,验证逻辑一行不用动。
/*
* Created by ArduinoGetStarted.com
*
* This example code is in the public domain
*
* Tutorial page: https://arduinogetstarted.com/tutorials/arduino-keypad
*/
#include "Keypad.h"
const int ROW_NUM = 4; //four rows
const int COLUMN_NUM = 3; //three columns
char keys[ROW_NUM][COLUMN_NUM] = {
{'1','2','3'},
{'4','5','6'},
{'7','8','9'},
{'*','0','#'}
};
byte pin_rows[ROW_NUM] = {9, 8, 7, 6}; //connect to the row pinouts of the keypad
byte pin_column[COLUMN_NUM] = {5, 4, 3}; //connect to the column pinouts of the keypad
Keypad keypad = Keypad( makeKeymap(keys), pin_rows, pin_column, ROW_NUM, COLUMN_NUM );
const String password = "1234"; // change your password here
String input_password;
void setup(){
Serial.begin(9600);
input_password.reserve(32); // maximum input characters is 33, change if needed
}
void loop(){
char key = keypad.getKey();
if (key){
Serial.println(key);
if(key == '*') {
input_password = ""; // clear input password
} else if(key == '#') {
if(password == input_password) {
Serial.println("password is correct");
// DO YOUR WORK HERE
} else {
Serial.println("password is incorrect, try again");
}
input_password = ""; // clear input password
} else {
input_password += key; // append new character to input password string
}
}
}串口里先按星号清空、输入 1234、按井号,就能看到 password is correct。要换密码改 password 那一行;要支持多个密码,用多个字符串逐个比对即可,ArduinoGetStarted 的密码门锁教程就是这个思路的加长版,后面还接了执行器做开锁动作,本文不展开。
复现小结与三个坑
- 引脚映射是第一大坑:排线顺序和代码数组的顺序必须一一对应,串口回显错键先查这里,再查代码。
- 串口没输出先查两处:波特率是不是 9600、行线有没有接反。行线的输入模式由库在 begin 阶段处理,不要自己再额外接上拉下拉去"帮忙"。
- input_password.reserve(32) 不是装饰:它给字符串预分配内存,避免 loop 里反复追加导致堆碎片,例程注释写明最大 33 个字符,超长密码要改这个值。
整套复现成本很低:一块 UNO、一张 4x4 薄膜键盘、8 根杜邦线、一个 3.1.1 的 Keypad 库。真正值得花时间的是把行列扫描吃透——这是很多更复杂输入方案的底子,自制键盘固件、旋转编码器阵列,走的都是同一套扫描思想。











getKey() 非阻塞这点很实用,配合 millis 做状态机正好,不然 delay 一加整个循环都卡住。
试了密码那段例程,1234 按井号确实回 correct,星号清空也好使。keymap 是 4x3 的这点楼主特意标出来了,比一些教程直接甩代码强。
reserve(32) 那个细节加分,好多人写 String 追加都不管内存碎片,跑久了真的会出怪问题。
8 根线撑 16 个键这个思路第一次见还是拆计算器的时候,现在轮到自己接线才明白行列交叉的妙处。
这篇文章把行列扫描讲到位了。之前接 4x4 键盘按 1 出 7,查了半天代码,最后发现是排线顺序和 colPins 数组对不上,跟文里说的第一大坑一模一样。引号形式的 #include 一开始还以为抄错了,查了 GCC 文档才知道对库搜索路径是等价的,学到了。