简介：针对STM32入门阶段常见的按键检测延迟与CPU空耗问题，这份外部中断EXTI按键控制LED灯工程资料给出了完整的解决方案。资源采用标准库开发方式，面向单片机初学者与嵌入式竞赛备赛者，系统演示了如何将PA0配置为外部中断输入、通过下降沿触发捕捉按键动作，并在中断服务函数中翻转LED状态，从而替代传统轮询扫描逻辑。压缩包共185个文件，除C源码、H头文件外，还包含uvprojx工程文件、编译生成的hex、axf、map文件以及链接脚本等，整体大小仅4.75MB，便于直接打开工程运行调试。已有4928人学习下载，在同类入门资料中热度较高。资料内不仅提供了可编译的Keil工程，还保留了EXTI_Init、NVIC_Init完整配置代码和中断标志位检测清除的规范写法。结合压缩包内附的Keil工程与源码，读者能很快掌握外部中断的初始化流程、触发方式选择、优先级分组等要点，并可进一步迁移至传感器信号检测、无线接收等需要实时响应的中断应用场景中。
1. 按键控制LED的另一种写法：为什么把轮询换成外部中断
做单片机开发的人大概率都写过这样的代码：主循环里不停读按键引脚电平，检测到按下就翻转LED。这套轮询逻辑在小demo里没啥问题，可一旦主循环里有显示刷新、传感器读取、通信处理这些耗时任务，按键响应就会变得时灵时不灵——按下去的瞬间CPU正在忙别的事，电平变化没有被及时捕获，轻则手感迟钝，重则直接丢按键。EXTI外部中断解决的就是这个痛点：引脚电平变化由硬件产生中断事件，CPU停下当前任务去处理按键，处理完再回到原来的活。这篇笔记把某开发板上的按键控制LED工程完整拆一遍，从EXTI的触发机制、NVIC中断优先级配置，到中断服务函数里如何消抖、如何翻转LED，最后给你几条调中断时最容易踩的坑和二次改造的路径。适合刚把GPIO点灯玩熟、想进阶中断开发的单片机入门者，也适合想翻翻别人工程结构的老手。
2. EXTI工作机制与工程骨架：触发条件、中断线映射和代码结构
2.1 外部中断的硬件基础：每条EXTI线背后对应一组引脚
STM32的EXTI（External Interrupt/Event Controller）不是每个引脚独立一个中断通道，而是按端口分组映射。以某型号芯片为例，GPIOA的Pin0、GPIOB的Pin0、GPIOC的Pin0统统映射到EXTI0这根中断线上，GPIOx的Pin1映射到EXTI1，以此类推。也就是说，同一时刻只能让其中一个引脚的Pin0使能EXTI0，不能同时让PA0和PB0都触发EXTI0，这是新手最容易踩的硬件限制。
按键控制LED这个demo里，按键接在PA0，对应的就是EXTI0线。PA0默认是高电平，按键按下把引脚拉到低电平，所以选择下降沿触发。芯片检测到PA0从高变低的那一个跳变沿，就会把EXTI0的挂起寄存器位置1，同时向NVIC发出中断请求。NVIC是嵌套向量中断控制器，它决定这个中断优不优先、要不要打断当前正在执行的主循环代码。
还有一点容易被忽略：EXTI有两种工作模式，中断模式和事件模式。中断模式会让CPU跳转到中断服务函数执行代码，事件模式只产生一个硬件事件脉冲，不触发CPU中断，一般配合其它外设使用。按键控制LED显然用中断模式，配置的时候不要把这两个搞混。
2.2 工程目录拆解：入门工程的文件该怎么摆
这份资源的工程结构延续了标准外设库的经典布局，用keil打开后是这样一个骨架：
Project ├─ User │ ├─ main.c │ ├─ stm32f10x_it.c │ └─ stm32f10x_it.h ├─ Hardware │ ├─ key.c │ ├─ key.h │ ├─ led.c │ └─ led.h ├─ System │ ├─ system_stm32f10x.c │ └─ stm32f10x_conf.h └─ Libraries ├─ CMSIS └─ STM32F10x_StdPeriph_Drivermain.c里放主函数和外设初始化调用，stm32f10x_it.c放中断服务函数，key.c和led.c分别是按键和LED的驱动封装，Libraries里是标准外设库源码。这个分层思路在进阶项目里同样适用：驱动代码和外设初始化分开，中断服务函数单独放一个文件，这样换板子或者加外设的时候不用满工程找代码。
后面要讲的初始化代码在main.c里，中断服务函数写在stm32f10x_it.c中，按键扫描和消抖逻辑封装在key.c里。比起把所有代码堆在一个main.c里，这种小工程按模块拆文件的好处是：调试中断服务函数的时候，只需要盯着stm32f10x_it.c看，主循环的改动不会误伤中断逻辑。
2.3 配置链路概览：从引脚到CPU要过几道关
在写代码之前，先把一条完整的中断响应路径理清楚。按键电平变化要最终触发CPU中断并执行你写的处理函数，中间要经过GPIO、EXTI、NVIC三关：
按键按下 -> GPIO引脚电平变化 -> EXTI边沿检测 -> EXTI挂起寄存器置位 -> NVIC中断仲裁 -> CPU跳转中断服务函数 -> 执行按键处理逻辑GPIO这一关要做的配置是：把PA0设为输入模式，选择上拉还是下拉。按键另一端接GND，空闲时引脚要保持高电平，所以用上拉输入。EXTI这一关要做的配置是：选择触发边沿（下降沿）、使能中断线0。NVIC这一关要做的配置是：打开EXTI0对应的中断通道，设置抢占优先级和子优先级。三关缺一不可，很多人中断进不去，多半是某一关的配置漏了。
3. 核心代码逐段拆解：从GPIO初始化到中断服务函数
3.1 GPIO初始化：上拉输入和推挽输出的配置细节
按键和LED的GPIO配置写在main函数开头。按键PA0要配成上拉输入，LED引脚（这里假设是PC13）配成推挽输出。标准外设库的GPIO_Init结构体里，每个字段都要明确赋值，少一个都可能出玄学问题。
void GPIO_Config(void) { GPIO_InitTypeDef GPIO_InitStructure; /* 使能GPIOA和GPIOC的时钟 */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOC, ENABLE); /* 按键引脚PA0：上拉输入，下降沿有效 */ GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; /* 上拉输入 */ GPIO_Init(GPIOA, &GPIO_InitStructure); /* LED引脚PC13：推挽输出，最大速度2MHz */ GPIO_InitStructure.GPIO_Pin = GPIO_Pin_13; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; /* 推挽输出 */ GPIO_InitStructure.GPIO_Speed = GPIO_Speed_2MHz; GPIO_Init(GPIOC, &GPIO_InitStructure); /* 初始状态：LED熄灭 */ GPIO_SetBits(GPIOC, GPIO_Pin_13); }GPIO_Mode_IPU是上拉输入，对应的还有GPIO_Mode_IPD下拉输入和GPIO_Mode_IN_FLOATING浮空输入。按键电路如果外部已经接了上拉电阻，这里用浮空输入也可以；但大多数开发板的按键是引脚直接接GND，板载上拉不一定有，所以内部上拉最稳妥。GPIO_Speed只对输出模式有意义，输入模式不用配速度，这块就算写了也不报错但没啥用。
时钟使能那行要留意：STM32外设复位后时钟默认是关闭的，不打开GPIOA的时钟，后面所有对PA0的配置都白写。这是新手初始化外设时最容易漏的一步。
3.2 EXTI初始化：选择触发边沿和中断线
GPIO配好之后，要把PA0连接到EXTI0线上，然后配置触发方式和中断使能。标准外设库里这两步是分开的函数，顺序不能乱：先建立GPIO和EXTI的映射关系，再配置EXTI本身。
void EXTI_Config(void) { EXTI_InitTypeDef EXTI_InitStructure; /* 将PA0映射到EXTI0线 */ GPIO_EXTILineConfig(GPIO_PortSourceGPIOA, GPIO_PinSource0); /* 配置EXTI0：下降沿触发，使能中断 */ EXTI_InitStructure.EXTIMode = EXTI_Mode_Interrupt; EXTI_InitStructure.EXTITrigger = EXTI_Trigger_Falling; /* 下降沿触发 */ EXTI_InitStructure.EXTI_Line = EXTI_Line0; EXTI_InitStructure.EXTI_LineCmd = ENABLE; EXTI_Init(&EXTI_InitStructure); }GPIO_EXTILineConfig这个函数的作用是把引脚和EXTI线绑定，参数里GPIO_PortSourceGPIOA表示端口选择A，GPIO_PinSource0表示引脚编号0。这里有个容易绕晕的点：EXTI_Line0对应的是引脚编号0，不管它是PA0、PB0还是PC0；EXTI_Line1对应引脚编号1，以此类推。EXTI_Trigger_Falling表示下降沿触发，也就是引脚从高电平跳变到低电平的那一瞬间触发中断。如果按键电路是另一端接高电平、按下接地，就用Falling；如果按键按下把引脚拉高，那就应该用EXTI_Trigger_Rising。
EXTI_Mode_Interrupt选择的是中断模式而不是事件模式，这意味着触发后CPU会真正跳转到中断服务函数执行代码。如果选成EXTI_Mode_Event，就只产生事件脉冲，CPU根本不会进中断。
3.3 NVIC配置：中断优先级的分组规则
NVIC决定的是“这个中断来了，CPU要不要理它、优先级多高”。在标准外设库里，NVIC配置分两步：先设置优先级分组，再使能具体的中断通道。
void NVIC_Config(void) { NVIC_InitTypeDef NVIC_InitStructure; /* 设置优先级分组：抢占优先级2位，子优先级2位 */ NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); /* 使能EXTI0中断通道 */ NVIC_InitStructure.NVIC_IRQChannel = EXTI0_IRQn; NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1; NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0; NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE; NVIC_Init(&NVIC_InitStructure); }NVIC_PriorityGroup_2是STM32的优先级分组方式之一，它把4位优先级拆成2位抢占优先级和2位子优先级。抢占优先级高（数值小）的中断可以打断抢占优先级低的中断，子优先级只在抢占优先级相同时才参与仲裁。按键中断这里只涉及一个中断源，分组怎么设其实影响不大，但养成显式配置的习惯，后面加定时器中断、串口中断的时候不会因为默认分组不对而踩坑。
EXIT0_IRQn是这个芯片中断向量表里的固定编号，不能自己编造。EXTI0中断对应着向量表里的第0号外部中断通道，不同引脚编号对应的IRQn不同，比如EXTI1是EXTI1_IRQn，EXTI9和EXTI5则共用EXTI9_5_IRQn。这点在用到多个按键的时候要特别留意，共用中断通道的多个中断线要在中断服务函数里逐个判断。
3.4 中断服务函数：读状态、清标志、消抖、翻转LED
中断服务函数是整个工程的核心。中断触发后CPU会跳到这里，函数里做四件事：判断中断源是不是EXTI0、清除中断挂起标志、做按键消抖、翻转LED电平。标准外设库里，中断标志位读取和清除有专门的函数。
void EXTI0_IRQHandler(void) { if (EXTI_GetITStatus(EXTI_Line0) != RESET) { /* 消抖延时：等待按键电平稳定 */ delay_ms(20); /* 再次确认按键确实处于按下状态 */ if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) == 0) { /* 翻转PC13电平 */ GPIO_WriteBit(GPIOC, GPIO_Pin_13, (BitAction)(1 - GPIO_ReadOutputDataBit(GPIOC, GPIO_Pin_13))); } /* 清除EXTI0中断挂起标志 */ EXTI_ClearITPendingBit(EXTI_Line0); } }先看EXTI_GetITStatus这个函数。它读取EXTI0的挂起寄存器，判断这次中断是不是真的来自按键这根线。在中断服务函数入口做这个判断属于标准写法，尤其是EXTI9_5这种共用中断通道的情况，入口不判断就分不清是哪个引脚触发的。
GPIO_ReadInputDataBit读的是引脚当前的输入电平。按下为0（低电平）才执行LED翻转，这层确认是为了过滤掉干扰脉冲——有些环境下引脚上的毛刺也能触发下降沿中断，但毛刺持续时间很短，等不到20ms后再次读取就会读到高电平，从而被过滤掉。LED翻转那段代码用了读改写的方式：先读当前输出状态，取反后写回。GPIO_WriteBit的第三个参数是BitAction枚举，强制转换成0或1来匹配。
最后一行EXTI_ClearITPendingBit非常关键。中断服务函数执行完后，如果不手动清除挂起标志，NVIC会认为中断事件还没处理完，可能导致同一个中断反复触发，或者影响下一次下降沿的捕获。清标志的动作放在函数末尾，在确认已经处理完这次中断事件之后。
3.5 标准外设库和HAL库的写法对照
如果你用的是HAL库而不是标准外设库，中断这部分代码结构会有变化。HAL库把GPIO、EXTI、NVIC的初始化封装成了更统一的风格，中断服务函数里不再需要手动读状态和清标志。
void EXTI0_IRQHandler(void) { HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_0); } void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { if (GPIO_Pin == GPIO_PIN_0) { HAL_Delay(20); if (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET) { HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); } } }HAL_GPIO_EXTI_IRQHandler内部会帮我们读取中断状态并清除挂起标志，然后调用弱定义的HAL_GPIO_EXTI_Callback回调函数，我们需要覆写这个回调来实现自己的逻辑。HAL库的优势是代码更简洁，GPIO_InitTypeDef里用结构体嵌套的方式配置引脚、模式、上下拉、速度，初始化代码比标准外设库少了几行，但背后的原理完全一致。这份资源用的是标准外设库版本，看懂之后切到HAL库只是改个API名字的事，中断的处理流程是不变的。
4. 避坑记录：中断进不去、抖动误触发、延时翻车
4.1 中断服务函数写了但进不去
现象：按键按下去，LED纹丝不动，打断点在中断服务函数里根本不停。原因分两种，要么NVIC没使能EXTI0中断通道，要么GPIO和EXTI的映射没建立。最常见的是第一种：初始化代码里写了GPIO_Config和EXTI_Config，却漏了NVIC_Config，结果CPU根本不知道有这回事。第二种是GPIO和EXTI配置顺序反了，先配置EXTI再配置GPIO，导致映射关系建立的时候引脚时钟还没打开。
解决：检查main函数里三个Config的调用顺序，严格按照GPIO、EXTI、NVIC的顺序执行。用调试器在EXTI0_IRQHandler入口打断点，如果断点没停，说明中断没有产生或没有被CPU接收，回头查NVIC_IRQChannel是不是EXTI0_IRQn。还有个别情况是按键引脚搞错了，硬件上按键接的是PA1却配了EXTI0，这种情况在GPIO_EXTILineConfig那行就能发现。
4.2 按下一次按键，LED状态翻转了两次
现象：按一次按键，LED亮一下又灭一下，看起来像执行了两次中断。原因是按键没有做正确的消抖。机械按键按下和释放的瞬间，金属触点会抖动，产生持续时间几毫秒到几十毫秒的不稳定电平，这个抖动过程里可能产生多个下降沿，每个下降沿都会触发一次EXTI中断。
解决：在中断服务函数里加延时消抖。检测到中断后先延时20ms，等信号稳定后再读一次引脚电平，确认确实是低电平才执行LED翻转。延时消抖的缺点是中断服务函数里做延时，会阻塞其他中断和主循环，如果项目里还有定时器中断或者串口中断，20ms的延时可能会影响实时性。进阶做法是，中断里只置一个标志位，由主循环检测到标志位后再做消抖和LED翻转，把耗时操作从中断上下文移出去。
4.3 中断里用了HAL_Delay或者delay_ms导致程序卡死
现象：按键中断能进，但进了之后整个程序卡住，主循环不跑了，其他中断也没反应。原因出在延时函数的实现上。不管是标准外设库还是HAL库，delay_ms通常都是依赖SysTick定时器实现的阻塞延时。如果SysTick的中断优先级比当前EXTI中断的优先级低，就会出现死锁：EXTI中断里等SysTick的延时计时，而SysTick中断被EXTI打断后迟迟得不到执行，延时永远结束不了。
解决：把SysTick中断优先级配置得比所有外设中断都高，这一般是默认行为，但如果你在NVIC配置里手动调整了SysTick的优先级，就很容易翻车。更稳妥的方案是避免在中断服务函数里做长时间延时，改用状态机消抖或者定时器辅助消抖。我在实际项目里习惯用“中断置标志位+主循环消抖”的方式，消抖延时放在主循环，中断里只做最轻量的事情。
4.4 EXTI_GetITStatus永远返回RESET
现象：中断能正常进入EXTI0_IRQHandler，但if (EXTI_GetITStatus(EXTI_Line0) != RESET)这个条件永远不成立，代码直接跳过处理逻辑。原因几乎都是把EXTI_Line参数写错了。检查一下你传进去的是EXTI_Line0还是EXTI_Line1，如果按键接的是PA0，清标志和读状态都必须用EXTI_Line0，用错了一根线，虽然中断能进（因为中断通道是EXTI0_IRQn），但标志位读的是另一根线的状态。
解决：保证EXTI_Line、EXTI_IRQn、GPIO_PinSource三个编号对应同一个引脚编号。养成一个习惯：所有涉及中断源编号的地方统一写成宏定义，比如#define KEY_EXTI_LINE EXTI_Line0、#define KEY_EXTI_IRQn EXTI0_IRQn、#define KEY_GPIO_SOURCE GPIO_PinSource0，三处共用同一个逻辑编号，改硬件的时候只改宏定义就行。
5. 编译烧录与在线调试：让中断“看得见”
5.1 用keil编译整个工程
拿到这份工程源码后，在keil里打开Project文件夹下的工程文件，第一次编译前要确认几件事：芯片型号和工程配置一致，标准外设库的头文件路径都加进来了。工程里用了标准外设库的很多模块，如果C/C++ Include Paths里缺了Libraries文件夹下的路径，编译会报一堆找不到头文件的错误。
编译时留意输出窗口的警告信息。EXTI和GPIO例程常见的警告是变量定义了未使用，地址对齐提示这类，一般不影响运行。但如果出现implicit declaration相关的警告，说明某个函数没有声明头文件就调用了，这时候要看key.h、led.h有没有被main.c正确include进来。
正常编译完成后，Output窗口会生成一个hex文件，路径通常在Project/Objects或者Output文件夹下。这个文件就是要烧录到芯片里的机器码。
5.2 烧录方式选择：下载器烧录和串口ISP
某开发板上可以选择两种烧录方式。第一种是用下载器，接线方式是下载器的SWDIO接芯片的SWDIO引脚，SWCLK接SWCLK引脚，GND接GND，然后在keil的Flash Download选项卡里选择对应的下载器型号，配置好端口后直接点击Download按钮。这种方式的好处是下载快、支持在线调试，缺点是下载器需要额外购买。
第二种是串口ISP烧录。某开发板上的串口芯片已经把USB转串口和BOOT电路做好了，把板上的启动模式跳线帽拨到ISP模式，用USB线连接电脑，再用厂商提供的下载工具选择生成的hex文件，点击下载即可。这种方式的优点是只需要一根USB线，缺点是每次烧录要手动切换启动模式，而且不支持在线调试。
对初学者来说，我建议优先用下载器方式，不是因为它下载快，而是因为在线调试功能对理解中断执行流程帮助非常大。如果手头只有USB线，先跑通ISP烧录也行，等后面需要排查复杂问题的时候再考虑配一个下载器。
5.3 在线调试：在中断服务函数里观察执行流程
用下载器烧录完成后，点keil的Debug按钮进入调试模式。在EXTI0_IRQHandler的第一行代码处打断点，然后全速运行程序。这时候按一下按键，程序会停在断点处，右边的Call Stack窗口能看到当前函数调用栈，Registers窗口能看EXTI挂起寄存器的值，这比瞎猜中断有没有触发直观得多，是排查中断类问题最快的方式。
调试中可以在Watch窗口添加表达式来观察变量。比如添加GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0)、EXTI_GetITStatus(EXTI_Line0)，单步执行时观察这些值的变化轨迹——中断刚触发时EXTI挂起标志是SET，延时消抖后引脚电平回到0，清除标志后挂起位变RESET。
需要注意的坑是：在调试模式下，如果按了暂停键停在中断服务函数里，再按全速运行的时候，按键已经释放了，可能导致消抖逻辑读到引脚为高电平，觉得是误触发而跳过处理。遇到这种情况不用慌，多做几次“按下按键-观察断点-继续运行”的操作，或者把断点加在GPIO_WriteBit那一行，重点观察翻转逻辑有没有被执行到。
6. 二次开发思路：从单按键到多中断、标志位架构与低功耗唤醒
6.1 从单按键扩展到多个按键
单片机上很多操作都需要多个按键配合。扩展的要点是理清中断线的映射关系：第二个按键如果是PB1，对应EXTI1，中断服务函数就要写到EXTI1_IRQHandler里；如果是PE5，那就要写进EXTI9_5_IRQHandler，通过EXTI_GetITStatus(EXTI_Line5)区分具体中断源。我习惯把按键对应的引脚号、EXTI线号、IRQn号统一用宏定义集中管理，新增按键只动宏定义和中断服务函数两处代码。
#define KEY1_GPIO_PORT GPIOA #define KEY1_GPIO_PIN GPIO_Pin_0 #define KEY1_EXTI_LINE EXTI_Line0 #define KEY1_EXTI_IRQn EXTI0_IRQn #define KEY1_GPIO_SOURCE GPIO_PinSource0这里必须注意一个限制：同一个EXTI线号在任意时刻只能使能一个引脚。如果两个按键都接在Pin0（比如PA0和PB0），只有其中一个能正常触发中断，这是芯片硬件层面的约束，软件绕不过去。设计按键电路的时候，尽量让每个按键分布在不同的Pin号上。
6.2 中断里只置标志位，主循环里做处理
前面避坑里提到的“中断里做延时”的隐患，在扩展多个按键之后会放大。多个按键中断同时进延时，程序实时性基本就废了。我在做过的一个小项目里用了一段很简单的标志位架构，效果不错：
volatile uint8_t key_flag = 0; void EXTI0_IRQHandler(void) { if (EXTI_GetITStatus(EXTI_Line0) != RESET) { key_flag = 1; EXTI_ClearITPendingBit(EXTI_Line0); } } while (1) { if (key_flag) { key_flag = 0; if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) == 0) { delay_ms(20); if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) == 0) { HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); } } } }标志位用volatile修饰是必须的，中断服务函数和主循环两个上下文都要访问这个变量，编译器如果把它优化进寄存器，主循环里可能永远读不到更新后的值。这样改写之后，中断里只做最轻量的事，消抖延时就放在主循环里，其它任务不会被阻塞。
6.3 从按键中断延伸到低功耗唤醒
EXTI不只是用来做按键控制，在低功耗应用里它经常扮演唤醒源的角色的。芯片进入睡眠模式后，主循环停摆，GPIO中断仍然可以唤醒CPU。外部中断的配置方式和这个demo几乎一样，区别只在于进入低功耗之前要让EXTI在睡眠模式下保持使能。
从那以后我每次写中断类代码都强制走一遍同样的流程：先确认GPIO映射和EXTI线号一致，再确认NVIC通道号没错，最后检查中断服务函数入口有没有清标志——这三步检查能省下大量靠调试器瞎猜的时间。希望这个工程的拆解过程，能帮你在自己的项目里少踩几个中断开发的坑。
本文还有配套的精品资源，点击获取
