STM32 HAL库矩阵键盘驱动：状态机消抖与长按识别实战

1. 项目缘起为什么矩阵按键驱动值得单独写一篇在嵌入式开发里按键输入是最基础的人机交互方式之一。当你的项目需要超过4个独立按键时如果还坚持用“一个GPIO口对应一个按键”的方案你会发现GPIO资源迅速告急电路板走线也变得复杂。这时候矩阵键盘就成了一个非常经典且高效的解决方案。它通过行和列的交叉扫描用NM个IO口就能实现N×M个按键的检测极大地节省了宝贵的硬件资源。我最近在做一个基于STM32F103的工业控制器面板上需要16个功能键。如果都用独立按键光是这16个键就得占掉16个IO再加上LED指示灯、通讯接口芯片的引脚根本不够用。所以矩阵键盘是唯一的选择。但在实际用STM32的HAL库去实现时我发现网上很多教程要么是标准库的移植起来麻烦要么只给个扫描函数的代码对于消抖处理、长按/短按识别、如何与主程序优雅地配合这些关键细节要么一笔带过要么干脆不提。踩过几个坑之后我决定把基于HAL库的4×4矩阵按键驱动从头到尾捋清楚。这篇内容不只是给你一段能跑的代码更重要的是讲明白背后的设计逻辑、HAL库下的实现要点以及那些只有实际调试过才会遇到的“坑”。比如为什么我的按键反应有时快有时慢长按功能怎么实现才不卡主循环IO口配置成开漏输出和推挽输出到底有啥区别这些我都会结合HAL库的特性给你掰开揉碎了讲。2. 硬件原理与电路设计不只是连线那么简单在写代码之前我们必须先吃透硬件。一个4×4矩阵键盘本质上是4行和4列导线交叉在每个交叉点上放置一个按键。当按键按下时对应的行线和列线就接通了。2.1 扫描原理行扫描与列扫描常见的扫描方式有两种行扫描和列扫描。原理是对称的这里以“行扫描列读取”为例来说明初始化将4根行线Row0-Row3配置为输出模式并默认输出高电平或低电平取决于电路设计。将4根列线Col0-Col3配置为输入模式并启用内部上拉电阻。逐行扫描第一轮让Row0输出低电平如果默认高电平其他行Row1-Row3输出高电平。然后立即读取所有列线Col0-Col3的状态。如果此时按键S00位于Row0和Col0交叉点被按下那么Col0这条线就会因为与Row0接通而被拉低。我们读取Col0发现它是低电平而其他列为高电平由此就能定位到S00被按下。如果没有任何按键按下所有列线都会因为内部上拉而保持高电平。完成第一行扫描后将Row0恢复为高电平。循环扫描接着让Row1输出低电平其他行高电平再次读取所有列线状态检测第二行的按键。如此循环完成4行的扫描。这个过程中“立即读取”非常关键。在HAL库中我们调用HAL_GPIO_ReadPin函数读取引脚电平。为了保证在行线电平稳定后再读取通常会在设置行线电平后插入一个极短的延时比如几微秒但这个延时在STM32的高速下往往可以忽略或者用__NOP()空指令替代。2.2 电路设计要点与IO配置选择电路设计直接决定了代码怎么写。最常见的有两种接法接法一行线接GND列线上拉。硬件4根行线一端接按键另一端直接连接到GND。4根列线通过电阻通常10kΩ上拉到VCC然后接到STM32的IO口。软件配置行线GPIO配置为推挽输出默认输出高电平。扫描某一行时将其设置为低电平相当于接通GND。列线GPIO配置为输入模式并启用内部上拉电阻对应GPIO_PULLUP。这样无按键时列线被上拉到高电平当该行按键按下列线被行线拉低到GND读取即为低电平。优点电路简单软件配置直观。内部上拉省去了外部电阻。缺点当同时按下同一列上的多个按键时虽然不常见可能会产生错误的读取。不过对于大多数应用可以忽略。接法二行线下拉列线接VCC。硬件4根行线通过电阻下拉到GND。4根列线一端接按键另一端接VCC。软件配置行线GPIO配置为开漏输出默认输出低电平内部强下拉。扫描时将目标行设置为高电平相当于释放被外部或内部上拉电阻拉高但开漏模式需要外部上拉。列线GPIO配置为输入模式并启用内部下拉电阻GPIO_PULLDOWN。无按键时列线被下拉到低电平按键按下时列线被行线的高电平拉高。优点功耗可能略优抗干扰能力在某些场景下稍好。缺点需要外部下拉电阻或者芯片内部下拉电阻足够强。配置稍复杂。我的选择与建议对于新手和绝大多数应用强烈推荐接法一。它硬件简单软件配置清晰利用STM32强大的内部上拉电阻几乎不需要外部元件。本教程后续代码也将基于这种接法。在CubeMX中配置列线输入上拉时记得检查芯片数据手册确认该IO口支持内部上拉且上拉电阻值通常40kΩ左右能满足你的扫描速度要求。2.3 防串键与二极管的作用什么是“串键”假设你同时按下了S00(R0,C0)和S11(R1,C1)。在行扫描到R0时C0被拉低我们检测到S00。这没问题。但当你扫描到R1时由于S11按下C1被拉低我们也能检测到S11。然而如果同时按下了S00和S10(R1,C0)呢当你扫描R0时C0被拉低检测到S00。扫描R1时电流路径可能是VCC - 上拉电阻 - C0 -S00- R0 - GND。这会导致在扫描R1时C0这条线也被拉低了于是你会错误地检测到S10也被按下尽管你只按了S00和S10中的一个。为了解决这个问题可以在每个按键上串联一个二极管方向从行指向列对于接法一。这样电流只能从行流向列防止了上述的逆向电流路径导致的误判。但是这增加了16个二极管成本和布局复杂度上升。对于4×4矩阵且不要求N键无冲即同时按下多个键互不影响的绝大多数场合可以不加二极管。我们的驱动代码需要意识到这一点并通过软件策略如“松手检测”或“互斥处理”来规避或减轻串键的影响。一个简单的策略是在一次完整的扫描周期内如果检测到多个按键可以视为无效或只取第一个这取决于你的应用逻辑。3. 软件驱动设计状态机才是消抖的终极答案直接在主循环里读取GPIO电平来判断按键是初学者最容易掉进去的坑。因为机械按键的触点闭合和断开时会产生持续数毫秒到数十毫秒的抖动这会导致一次物理按压被误识别为多次。更高级的需求比如区分短按、长按、连按就更难以实现了。3.1 按键扫描状态机FSM设计使用有限状态机FSM是处理按键最稳健的方法。它将按键的生命周期划分为几个状态通过定时扫描来驱动状态转移。这里我们设计一个4状态机状态0检测按下KEY_STATE_CHECK_PRESS行为调用底层扫描函数检测是否有按键被按下电平变化。转移条件如果检测到有效按键比如某一行某一列为低电平则启动一个去抖延时计时器比如20ms并进入状态1。否则保持在本状态。状态1消抖确认KEY_STATE_DEBOUNCE_PRESS行为等待去抖延时结束。在此期间持续检测按键是否仍然保持按下状态。转移条件如果计时未到保持等待。如果计时到了且按键依然处于按下状态则确认这是一次有效的“按下事件”记录键值并启动长按计时器比如1秒进入状态2。如果在计时期间按键电平恢复了可能是抖动则认为是抖动丢弃本次检测回到状态0。状态2等待释放或长按KEY_STATE_PRESSED行为按键已确认按下。在此状态我们做两件事检查长按持续检查长按计时器。如果计时器超时则触发“长按事件”并可以重置一个连按间隔计时器用于实现长按期间的连续触发比如每秒触发一次。检查释放持续扫描按键是否被释放电平恢复。转移条件如果检测到按键释放则启动一个释放消抖延时计时器可略短如10ms进入状态3。如果长按计时器超时触发长按事件但状态不立即改变依然停留在此状态等待释放。状态3消抖确认释放KEY_STATE_DEBOUNCE_RELEASE行为等待释放消抖延时结束。转移条件如果计时未到保持等待。如果计时到了且按键确实处于释放状态则确认这是一次有效的“释放事件”。此时根据长按是否已触发来决定触发“短按事件”还是仅完成一次按压周期。完成后回到状态0。如果在计时期间按键又变成按下可能是释放时的抖动则回到状态2。这个状态机被一个定时器中断比如SysTick或者一个基本定时器周期5-10ms周期性调用。每次中断对所有16个按键或按行并行执行一次状态转移判断。这样按键处理就与主循环解耦了主循环只需要查询是否有按键事件发生即可。3.2 基于HAL库的底层扫描函数实现状态机需要底层函数来获取最原始的按键电平状态。这个函数要高效因为它会被频繁调用。/** * brief 扫描4x4矩阵键盘返回当前按下的键值原始值未消抖 * param None * retval 按下的键值范围1-16。0表示无按键按下。 * note 此函数基于“行线推挽输出低电平有效列线输入上拉”的硬件接法。 */ uint8_t MatrixKey_Scan(void) { uint8_t row, col; uint8_t key_value 0; // 循环扫描4行 for(row 0; row 4; row) { // 1. 设置当前行为低电平其他行为高电平 switch(row) { case 0: HAL_GPIO_WritePin(ROW0_GPIO_Port, ROW0_Pin, GPIO_PIN_RESET); // 拉低 HAL_GPIO_WritePin(ROW1_GPIO_Port, ROW1_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(ROW2_GPIO_Port, ROW2_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(ROW3_GPIO_Port, ROW3_Pin, GPIO_PIN_SET); break; case 1: HAL_GPIO_WritePin(ROW0_GPIO_Port, ROW0_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(ROW1_GPIO_Port, ROW1_Pin, GPIO_PIN_RESET); // 拉低 HAL_GPIO_WritePin(ROW2_GPIO_Port, ROW2_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(ROW3_GPIO_Port, ROW3_Pin, GPIO_PIN_SET); break; // ... 类似地处理 case 2, case 3 } // 2. 短暂延时等待电平稳定对于几十MHz的MCU通常需要几个NOP // __NOP(); __NOP(); __NOP(); __NOP(); // 3. 读取列线状态 if(HAL_GPIO_ReadPin(COL0_GPIO_Port, COL0_Pin) GPIO_PIN_RESET) { col 0; key_value row * 4 col 1; // 键值计算为 1~16 // 找到按键后恢复行线状态并立即返回防止多键干扰本次扫描 MatrixKey_ResetRows(); return key_value; } if(HAL_GPIO_ReadPin(COL1_GPIO_Port, COL1_Pin) GPIO_PIN_RESET) { col 1; key_value row * 4 col 1; MatrixKey_ResetRows(); return key_value; } // ... 类似地读取 COL2, COL3 // 4. 恢复当前行为高电平准备扫描下一行 MatrixKey_ResetRows(); // 将所有行置高 } // 5. 扫描完所有行都未发现低电平列返回0 return 0; } /** * brief 将所有行线恢复为高电平默认状态 */ static void MatrixKey_ResetRows(void) { HAL_GPIO_WritePin(ROW0_GPIO_Port, ROW0_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(ROW1_GPIO_Port, ROW1_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(ROW2_GPIO_Port, ROW2_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(ROW3_GPIO_Port, ROW3_Pin, GPIO_PIN_SET); }关键点解析效率一旦在某一行检测到有列被拉低就立即计算键值并返回不再扫描后续行。这提高了响应速度但也意味着这个函数一次调用最多检测一个按键。对于多键同时按下的处理需要更复杂的逻辑比如记录所有被拉低的行列组合。恢复行线在检测到按键后和返回前必须将所有行线恢复为高电平。这是一个好习惯可以避免因为函数提前返回而让某一行持续输出低电平影响后续扫描或增加功耗。键值映射row * 4 col 1是一种常见的映射方式将行列索引转换为1~16的整数。你可以根据你的键盘布局比如电话键盘布局1-9、*、0、#来重新定义这个映射关系。3.3 状态机与事件回调的整合有了底层扫描函数和状态机设计我们需要一个数据结构来管理每个按键或整个键盘的状态。typedef enum { KEY_STATE_IDLE, // 空闲未检测到按下 KEY_STATE_DEBOUNCE_PRESS, // 按下消抖中 KEY_STATE_PRESSED, // 已确认按下等待释放或长按 KEY_STATE_DEBOUNCE_RELEASE // 释放消抖中 } KeyState_t; typedef struct { KeyState_t state; // 当前状态 uint8_t key_value; // 物理键值1-16 uint32_t debounce_tick; // 消抖计时器 uint32_t long_press_tick; // 长按计时器 uint8_t long_press_flag; // 长按事件已触发标志 } MatrixKey_t; // 事件类型通过回调函数通知应用层 typedef enum { KEY_EVENT_NONE, KEY_EVENT_SHORT_PRESS, // 短按按下并释放且未达到长按时间 KEY_EVENT_LONG_PRESS, // 长按按下持续时间超过阈值 KEY_EVENT_PRESSED, // 按下事件消抖后立即触发用于某些实时响应 KEY_EVENT_RELEASED // 释放事件 } KeyEvent_t; // 定义一个键盘对象管理所有按键简化版实际可能需要16个实例或一个状态数组 MatrixKey_t my_keyboard; // 应用层需要实现的回调函数指针 void (*KeyShortPressCallback)(uint8_t key_val); void (*KeyLongPressCallback)(uint8_t key_val);然后在一个定时中断服务程序如1ms定时器中调用状态机处理函数void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim-Instance KEY_SCAN_TIM_INSTANCE) // 你用来做按键扫描的定时器 { MatrixKey_StateMachineHandler(my_keyboard); } } void MatrixKey_StateMachineHandler(MatrixKey_t *key) { uint8_t current_scan_val MatrixKey_Scan(); // 获取当前原始键值 switch(key-state) { case KEY_STATE_IDLE: if(current_scan_val ! 0) { key-key_value current_scan_val; key-debounce_tick HAL_GetTick(); // 记录当前时间戳 key-state KEY_STATE_DEBOUNCE_PRESS; } break; case KEY_STATE_DEBOUNCE_PRESS: // 检查是否还在消抖时间内 if((HAL_GetTick() - key-debounce_tick) DEBOUNCE_PRESS_MS) // 例如20ms { // 消抖时间到再次确认按键是否仍被按下 if(MatrixKey_Scan() key-key_value) // 注意这里重新扫描确认是同一个键 { key-state KEY_STATE_PRESSED; key-long_press_tick HAL_GetTick(); // 开始长按计时 key-long_press_flag 0; // 可选立即触发一个“按下”事件用于需要快速响应的场景 if(KeyPressedCallback ! NULL) { KeyPressedCallback(key-key_value); } } else { // 抖动回到空闲状态 key-state KEY_STATE_IDLE; } } // 如果消抖时间内键值变了可能是干扰或另一个键也回到空闲 else if(current_scan_val ! 0 current_scan_val ! key-key_value) { key-state KEY_STATE_IDLE; } break; case KEY_STATE_PRESSED: // 首先检查是否已经释放 if(MatrixKey_Scan() ! key-key_value) { // 按键释放了进入释放消抖 key-debounce_tick HAL_GetTick(); key-state KEY_STATE_DEBOUNCE_RELEASE; break; } // 按键仍被按住检查长按 if(!key-long_press_flag) { if((HAL_GetTick() - key-long_press_tick) LONG_PRESS_MS) // 例如1000ms { key-long_press_flag 1; // 触发长按事件 if(KeyLongPressCallback ! NULL) { KeyLongPressCallback(key-key_value); } } } // 这里可以添加长按连发逻辑 break; case KEY_STATE_DEBOUNCE_RELEASE: if((HAL_GetTick() - key-debounce_tick) DEBOUNCE_RELEASE_MS) // 例如10ms { // 释放消抖时间到确认释放 if(MatrixKey_Scan() 0) // 确保没有按键被按下 { // 根据是否触发过长按决定触发短按事件 if(!key-long_press_flag KeyShortPressCallback ! NULL) { KeyShortPressCallback(key-key_value); } // 重置状态机 key-state KEY_STATE_IDLE; key-key_value 0; } else { // 释放抖动可能又按下了回到PRESSED状态重新判断 // 这里需要小心处理可能要根据当前扫描到的键值是否与之前一致来决定 // 简单处理直接回到PRESSED状态 key-state KEY_STATE_PRESSED; } } break; default: key-state KEY_STATE_IDLE; break; } }这个状态机 handler 是驱动层的核心。它确保了可靠的消抖通过时间戳对比严格过滤抖动。长按/短按识别清晰地区分了两种不同的交互意图。非阻塞所有操作基于时间判断不依赖HAL_Delay不影响系统实时性。事件驱动通过回调函数通知应用层耦合度低。4. CubeMX配置与工程集成要点理论讲完了我们来看看在STM32CubeMX和Keil/IAR工程里具体怎么操作。4.1 GPIO配置打开CubeMX选择你的STM32芯片型号。配置行线ROW0-ROW3找到4个你计划用作行线的GPIO口例如PA0-PA3。模式设置为GPIO_Output。输出级别Output level初始设为High高电平。上下拉Pull-up/Pull-down设为No pull-up and no pull-down因为我们是推挽输出驱动能力强不需要。用户标签User Label建议设为ROW0,ROW1...这样生成的代码可读性更好。配置列线COL0-COL3找到4个你计划用作列线的GPIO口例如PA4-PA7。模式设置为GPIO_Input。上下拉Pull-up/Pull-down设为Pull-up启用内部上拉电阻。这是关键用户标签设为COL0,COL1...配置一个定时器用于按键扫描。SysTick虽然可以用但它通常用于HAL库延时不建议占用。最好用一个基本定时器如TIM6/TIM7。在Timers里选一个比如TIM6。时钟源Clock Source选择Internal Clock。参数设置Parameter SettingsPrescaler预分频器根据你的系统时钟计算。假设系统时钟72MHz我们希望定时器1ms中断一次。则定时器时钟 72MHz / (Prescaler 1)。设置Prescaler为71则定时器时钟为1MHz。Counter Period自动重装载值ARR1MHz * 0.001s 1000。设置Counter Period为999因为从0开始计数。开启定时器中断在NVIC Settings中勾选TIM6 global interrupt。4.2 生成代码与驱动文件集成点击GENERATE CODE生成工程。在工程中新建matrix_key.c和matrix_key.h文件。将前面章节的扫描函数、状态机结构体、处理函数等代码放入.c文件。在matrix_key.h中声明公共函数和外部变量。在main.c中#include matrix_key.h在/* USER CODE BEGIN PV */区域定义你的键盘对象和回调函数MatrixKey_t my_keyboard; void MyKeyShortPressCB(uint8_t key) { /* ... */ }在/* USER CODE BEGIN 2 */区域初始化键盘对象并注册回调my_keyboard.state KEY_STATE_IDLE; KeyShortPressCallback MyKeyShortPressCB;然后启动定时器HAL_TIM_Base_Start_IT(htim6);确保定时器中断回调函数HAL_TIM_PeriodElapsedCallback中调用了你的MatrixKey_StateMachineHandler。4.3 避坑指南那些我踩过的雷GPIO速度配置在CubeMX的GPIO配置里有个“GPIO output speed”。对于按键扫描这种低速应用选最低的Low就行。选太高如Very High可能会增加不必要的功耗和噪声。中断优先级如果你的系统还有其他中断如串口、ADC注意安排好定时器中断的优先级。按键扫描的实时性要求不高可以设为较低的优先级避免干扰更重要的中断。状态机执行时间确保你的状态机处理函数MatrixKey_StateMachineHandler的执行时间远小于定时器中断周期如1ms。如果函数太复杂考虑优化代码或者延长定时器周期如5ms。可以在函数入口和出口用IO口翻转测试一下执行时间。键值映射表前面代码中row * 4 col 1是线性映射。但你的键盘物理布局可能不是这样。强烈建议在.h文件中定义一个键值映射表将扫描得到的原始索引0-15映射为你想要的逻辑键值如字符‘1’, ‘2’, … ‘#’。const char KeyMap[16] {1, 2, 3, A, 4, 5, 6, B, 7, 8, 9, C, *, 0, #, D};在回调函数里使用KeyMap[key_val - 1]来获取逻辑键值。多按键处理与“鬼影”前面提到我们的扫描函数一次只返回一个键值。如果要求支持同时按下多个键如组合键就需要修改扫描函数让它能返回一个位图比如一个16位的变量每一位代表一个按键的状态并且状态机也要能处理多个按键的独立状态。这复杂度会大大增加需要为每个按键维护独立的状态机实例。对于4×4矩阵不加二极管很难实现真正的全键无冲这点要有心理预期。5. 进阶优化与调试技巧当基础功能跑通后可以考虑下面这些优化让你的键盘驱动更健壮、更好用。5.1 低功耗优化策略如果你的设备是电池供电那么矩阵键盘扫描可能是耗电大户之一因为你需要定时器一直运行GPIO也在不断切换。降低扫描频率人眼和手指的响应时间在几十毫秒量级。完全可以将扫描定时器周期从1ms改为10ms甚至20ms。这样状态机的消抖时间也要相应调整比如改为30ms/15ms。这能直接降低CPU唤醒频率。使用外部中断唤醒这是更极致的省电方法。将4根列线配置为输入上拉同时连接到外部中断引脚上并配置为下降沿触发。当任何按键被按下列线电平被拉低触发中断。在中断服务程序里你再启动定时器进行密集扫描以识别具体是哪个键。识别完成后再次关闭定时器进入低功耗模式。STM32的EXTI支持多个GPIO连接到同一个中断线你可以巧妙配置。IO口状态管理在非扫描状态确保所有行线输出高电平对于我们的接法。对于开漏接法则要输出低电平。避免IO口处于不确定状态产生漏电流。5.2 使用DMA定时器实现“无CPU干预”扫描高级这是一个非常炫技但高效的思路适合对实时性要求极高的系统。原理是利用定时器触发DMA让DMA自动控制GPIO的位设置/清除寄存器BSRR/BRR来循环改变行线的输出同时用另一个DMA通道将列线输入数据寄存器IDR的值搬运到内存中。配置定时器产生一个固定频率的触发信号TRGO比如10kHz。配置DMA1控制行线源地址一个存储在RAM中的数组比如row_pattern[4] {0xFEFF, 0xFDFF, 0xFBFF, 0xF7FF}假设行线在GPIOA的0-3位低电平有效。每个元素代表一次扫描时GPIOA的BSRR寄存器应设置的值低4位用于Set高4位用于Reset这里需要仔细计算BSRR是32位寄存器。更简单的方法是使用GPIO的ODR寄存器。目标地址GPIOA-ODR输出数据寄存器的地址。传输宽度半字或字。模式循环模式。触发源定时器的TRGO事件。配置DMA2读取列线源地址GPIOB-IDR假设列线在GPIOB的地址。目标地址RAM中的一个循环缓冲区col_buffer[4]。触发源同一个定时器的TRGO事件。这样每次定时器触发DMA1自动切换一行输出同时DMA2自动读取一次所有列线的状态。这样CPU完全不用管扫描过程只需要定期比如每4次DMA传输后去检查col_buffer里的数据就能知道按键状态。这大大解放了CPU。但配置相当复杂需要对DMA和定时器联动有深入理解且会占用两个DMA通道。除非你的系统CPU负载真的非常紧张否则用状态机定时器中断的方案已经足够优秀。5.3 调试与问题排查当你的键盘不工作或者行为异常时可以按以下步骤排查硬件检查万用表测电压在无按键时测量列线电压应该是VCC约3.3V因为有上拉。按下某个键时对应的列线电压应被拉低到接近0V。逻辑分析仪/示波器这是最强大的工具。抓取行线和列线的波形。你应该能看到行线依次变低同时观察对应的列线是否在行线变低期间如果按键按下会产生一个低电平脉冲。可以清晰看到扫描周期和消抖过程。软件检查打印调试在状态机的每个状态转移点通过串口打印当前状态和键值。这是最直观的方法。IO口模拟指示灯用另一个IO口接个LED在扫描函数或状态机关键点翻转LED电平用示波器看LED波形可以粗略判断函数执行时间和频率。检查CubeMX生成的初始化代码确保MX_GPIO_Init()函数里你的行线和列线配置正确。特别是上拉电阻是否启用。检查中断确认定时器中断是否真的进入了。可以在中断回调函数里翻转一个IO口来测试。常见问题按键无反应首先检查硬件连接再用打印法确认MatrixKey_Scan函数是否能返回非零值。然后检查定时器是否启动状态机是否被调用。按键反应迟钝可能是扫描周期太长了或者消抖时间设置过长比如设了100ms。将定时器中断周期调到5-10ms消抖时间调到20ms试试。偶尔连击或失灵大概率是消抖没做好。检查你的消抖逻辑确保在DEBOUNCE状态里持续检测的是同一个键。也可能是硬件接触不良。同时按多个键出错这是矩阵键盘的固有缺陷鬼影。如果应用不允许同时按多个键可以在软件里加入互斥逻辑一旦检测到两个键就视为无效。如果必须支持考虑增加二极管或使用更复杂的扫描和识别算法。最后把整个驱动模块化做好头文件保护提供清晰的初始化、注册回调、启动扫描的API。这样下次在另一个STM32项目里用到矩阵键盘你就可以直接把这个matrix_key文件夹拖过去稍微修改一下GPIO定义和映射表就能快速投入使用这才是我们写一个高质量驱动的最终目的。