树莓派Pico使用C语言实现按键中断的困惑求助

核心问题分析 #

你遇到的中断程序卡死、gpio_get在中断里失效的情况，大概率是新手常犯的几个错误：指针误用、中断上下文违规操作、中断配置错误，或者代码语法遗漏（比如括号）导致逻辑混乱。

具体排查&修复要点 #

• 中断回调的参数传递别踩坑
  如果你给中断回调传了局部变量的地址（比如主函数里定义的临时变量），主函数执行完后局部变量会被销毁，回调时访问这个地址会触发内存错误，直接卡死Pico。必须用全局变量或者static修饰的变量来存需要在回调里访问的数据（比如LED状态、引脚列表）。

• 中断回调里别做复杂操作
  Pico的中断上下文资源有限，不能在回调里用printf、sleep_ms这类阻塞/耗时函数（示例里的简单消抖是权宜之计，实际最好用定时器消抖），否则会打乱系统调度导致卡死。回调里只做最核心的状态切换操作就行。

• gpio_get在中断里的正确用法
  gpio_get本身可以在中断里用，但如果你对指针不熟，很可能把指针变量当成引脚号传入（比如误写gpio_get(&key_pin)而不是gpio_get(key_pin)），这种错误会导致读取错误的内存地址，触发崩溃。检查你的代码里gpio_get的参数是不是正确的引脚编号，不是指针。

• 中断触发配置必须匹配硬件电路
  比如你的按键如果是一端接GND、一端接GPIO，必须给GPIO开启上拉电阻（gpio_pull_up(key_pin)），同时把中断触发方式设为GPIO_IRQ_EDGE_FALLING（按键按下时电平从高变低）。如果没开上拉，引脚会悬空，导致频繁触发中断，直接卡死系统。

• 检查代码的括号遗漏
  比如if、for语句的代码块没加括号，导致逻辑执行错误。比如你想在中断回调里执行多段代码，但没加括号，实际只执行了第一行，后续代码跑到了错误的上下文里，引发崩溃。

可运行的参考示例 #

#include "pico/stdlib.h"

#define KEY_PIN 15
uint8_t led_pins[] = {16, 17, 18, 19, 20};
uint8_t current_led = 0; // 全局变量存当前点亮的LED索引

// 按键中断回调函数
void key_callback(uint gpio, uint32_t events) {
    // 简单消抖：过滤按键抖动的误触发
    sleep_ms(20);
    if (gpio_get(KEY_PIN) == 0) {
        // 先熄灭所有LED
        for (int i = 0; i < 5; i++) {
            gpio_put(led_pins[i], 0);
        }
        // 切换到下一个LED
        current_led = (current_led + 1) % 5;
        gpio_put(led_pins[current_led], 1);
    }
}

int main() {
    stdio_init_all();

    // 初始化LED引脚为输出
    for (int i = 0; i < 5; i++) {
        gpio_init(led_pins[i]);
        gpio_set_dir(led_pins[i], GPIO_OUT);
    }
    // 点亮第一个LED作为初始状态
    gpio_put(led_pins[0], 1);

    // 初始化按键引脚为输入，开启上拉电阻
    gpio_init(KEY_PIN);
    gpio_set_dir(KEY_PIN, GPIO_IN);
    gpio_pull_up(KEY_PIN);

    // 配置中断：下降沿触发，绑定回调函数
    gpio_set_irq_enabled_with_callback(KEY_PIN, GPIO_IRQ_EDGE_FALLING, true, &key_callback);

    // 主循环只做闲置处理
    while (1) {
        sleep_ms(1000);
    }
}

补充：非中断程序效果未达预期的原因 #

不带中断的轮询程序效果不对，大概率是没处理按键消抖——按键按下时会有几毫秒的电平抖动，导致程序多次触发状态切换。你可以在轮询时加个延时，判断按键电平稳定后再执行切换逻辑。

内容的提问来源于stack exchange，提问作者Alphonse Reitz