企业官网建设流程全解析

1. 按键按下那一刻，GPIO 到底读到了什么

很多人第一次把按键接到 STM32 上，代码写得飞快：开时钟、配 GPIO、写个if(GPIO_ReadInputDataBit(...) == 0)，烧进去一看，灯亮了，收工。但如果你多按几下，或者把手指放在按键上不按，偶尔会发现灯自己闪一下；再或者把板子拿到电机旁边，按键没碰，输入状态却像抽风一样乱跳。这时候问题就来了：GPIO 输入到底读到了什么？是按键的机械动作，还是引脚上的电压，还是某个寄存器里被采样后的一个比特？这三个答案其实都对，但层次完全不同。

这篇内容就是围绕这个看似简单、实际坑点密集的问题展开的。我会从 GPIO 内部结构讲起，把GPIO_Mode_IPU、GPIO_Mode_IN_FLOATING这些模式为什么存在、什么时候选哪个说清楚，再把GPIO_ReadInputDataBit背后读的到底是哪个寄存器、为什么有时候读到的值和万用表量出来的不一样讲透。适合刚接触 STM32 的嵌入式新手，也适合做过几个项目但一直靠“抄配置”过日子的朋友。看完你至少能明白：按键电路不是随便接个电阻就行，输入模式也不是复制粘贴就能稳。

2. 先搞清楚：GPIO 输入读的不是“按键”，是引脚电压

2.1 从按键到寄存器，中间隔了四层

很多教程一上来就讲“按键按下读低电平”，但这句话省略了太多中间环节。一个按键从物理动作到你在代码里读到 0 或 1，中间至少经过四层转换：

第一层是机械层。按键本质是一个弹簧片开关，按下时两个触点接触，松开时断开。但机械触点有个讨厌的特性：在接触和分离的瞬间，金属片会弹跳几次，产生一串快速的高低电平脉冲，持续时间通常在 5ms 到 20ms 之间。这就是所谓的按键抖动。你在代码里读一次就判断，读到的可能是抖动中的任意一个瞬间。

第二层是电路层。按键本身只负责通断，它不能决定引脚在断开时是什么电平。如果按键一端接引脚、另一端接地，按下时引脚接地为低，松开时引脚悬空——悬空引脚的电压是不确定的，可能被周围电场、手指、PCB 走线耦合出任意值。所以必须加一个上拉或下拉电阻，给悬空状态一个确定的默认电平。

第三层是芯片内部采样层。STM32 的 GPIO 输入并不是直接把你引脚上的模拟电压原封不动送到寄存器。引脚电压先经过施密特触发器整形，变成干净的数字 0 或 1，然后在 APB2 时钟的驱动下，每个时钟周期采样一次，写入输入数据寄存器IDR。也就是说，你读到的值其实是“上一个采样时刻引脚电压经过整形后的数字结果”。

第四层是软件读取层。GPIO_ReadInputDataBit这个函数做的事情，本质上就是读IDR寄存器的某一位，然后返回 0 或 1。它不触发任何新的采样，也不做消抖，只是把最近一次硬件采样的结果搬给你。

把这四层串起来看，你就明白了：你读到的既不是按键的物理状态，也不是引脚上的瞬时电压，而是“引脚电压经过整形后、在最近一个采样周期被锁存进 IDR 的那个比特”。这个认知非常重要，后面很多奇怪现象都能用它解释。

2.2 IDR 寄存器：你真正读的那个东西

STM32 的每个 GPIO 端口都有一组寄存器，输入相关的核心是IDR（Input Data Register）。以常见的 STM32F103 为例，GPIOA_IDR的地址是0x40010808，这是一个 32 位寄存器，低 16 位对应 PA0 到 PA15，高 16 位保留。每一位的值就是对应引脚最近一次采样到的电平。

GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0)展开后大概是这样：

uint8_t GPIO_ReadInputDataBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin) { uint8_t bitstatus = 0x00; if ((GPIOx->IDR & GPIO_Pin) != (uint32_t)Bit_RESET) { bitstatus = (uint8_t)Bit_SET; } else { bitstatus = (uint8_t)Bit_RESET; } return bitstatus; }

它做的就是一次按位与。所以你读到的值，完全取决于IDR里那一位当前是什么。而IDR的更新，是由 GPIO 外设的采样逻辑自动完成的，跟你调不调这个函数没关系。你一天不读，它也在那儿按周期刷新。

这里有个容易被忽略的点：IDR 是只读的，你写它没有意义。有些新手想通过写 IDR 来“设置输入值”，这是不可能的。输入值只由引脚电压决定。另外，如果你配置的是输出模式，IDR 仍然会反映引脚的实际电平，这个特性在做开漏输出回读或者检测输出是否被外部拉低时很有用。

2.3 施密特触发器：为什么 1.8V 可能读成 0，也可能读成 1

引脚上的电压不是理想的 0V 或 3.3V。由于走线电阻、外部干扰、上拉电阻分压等原因，实际电压可能落在中间区域。STM32 的输入引脚内部有一个施密特触发器，它有两个阈值：上升阈值VT+和下降阈值VT-。对于 3.3V 供电的 STM32，VT+大约在 1.8V 到 2.0V 之间，VT-大约在 1.0V 到 1.2V 之间（具体看数据手册）。

这意味着：当引脚电压从低往高爬升时，必须超过VT+才会被识别为 1；当电压从高往低下降时，必须低于VT-才会被识别为 0。如果电压停在 1.5V 不动，那么它保持之前的状态不变。这个滞回特性本来是为了抗噪声，但也带来一个现象：同样一个 1.5V 的电压，如果之前是低电平，读出来还是 0；如果之前是高电平，读出来还是 1。所以你不能用万用表量到一个中间电压，就断定代码会读成什么。

这也是为什么浮空输入在引脚悬空时读数完全不可预测。悬空引脚的电压可能漂在任意值，可能因为一次采样超过阈值就翻成 1，下一次又掉回来。如果你把按键配成GPIO_Mode_IN_FLOATING又不加上拉电阻，松开按键时引脚就是悬空的，读数随机跳变，这不是芯片坏了，是你没给它一个确定的默认电平。

3. 四种输入模式，到底该选哪一个

3.1 浮空、上拉、下拉、模拟，一张表说清

STM32 的 GPIO 输入模式常见的有四种：浮空输入、上拉输入、下拉输入、模拟输入。很多人配的时候只记得“按键用上拉”，但不知道为什么，换个场景就懵了。下面这张表把关键区别列清楚：

这里要特别说清楚：上拉和下拉电阻是芯片内部的，阻值通常在 30k 到 50k 欧姆之间，而且误差不小。它适合短距离、低干扰的场景，比如板子上的小按键。如果你的按键通过排线拉到面板上，线长几十厘米，内部弱上拉很容易被外部干扰盖过，这时候应该在外面加一个 4.7k 到 10k 的强上拉，同时把引脚配成浮空输入或者上拉输入都行，外部电阻会主导电平。

3.2 为什么按键常用上拉而不是下拉

按键接法有两种：一端接地、一端接引脚，配上拉；或者一端接 VCC、一端接引脚，配下拉。两种都能用，但实际项目里上拉更常见，原因有几个。

第一，历史习惯和电路习惯。早期很多逻辑电路是低电平有效，按键按下拉低表示“有动作”，这种约定沿用至今。第二，接地比接 VCC 更方便。PCB 上地平面到处都是，按键一端直接连地，走线简单；如果接 VCC，还得考虑电源走线和去耦。第三，安全考虑。如果按键线意外碰到外壳或者地，上拉接法只是持续读到低，不会造成电源短路；下拉接法如果按键线碰到 VCC，可能引入意外电流。

但这不是绝对的。如果你的系统里 VCC 和地都很方便，下拉也完全没问题。关键是默认电平要确定，不能悬空。

3.3 内部上拉够不够用，什么时候必须加外部电阻

我见过不少项目，按键直接接引脚和地，配置成GPIO_Mode_IPU，板子单独测试没问题，一装到设备里就偶尔误触发。原因就是内部上拉太弱，长线像天线一样拾取干扰。判断要不要加外部上拉，可以看几个信号：

• 按键到引脚的走线超过 10cm，建议加外部上拉。
• 设备附近有电机、继电器、无线模块，建议加外部上拉。
• 按键是金属面板，人手触摸会引入工频干扰，建议加外部上拉。
• 低功耗场景要仔细算：内部上拉在按键按下时会持续消耗电流，如果按键经常被按住，可能比外部大电阻更费电。

外部上拉的阻值怎么选？假设你用 3.3V 供电，希望按下时电流不超过 1mA，那么电阻至少 3.3k。常见选 4.7k 或 10k。4.7k 抗干扰更强但耗电略大，10k 折中。如果走线很长，可以降到 2.2k，但要确认按键和引脚能承受这个电流。同时别忘了，外部上拉和内部上拉会并联，总阻值变小，如果你配了GPIO_Mode_IPU又加外部上拉，实际等效上拉是两者并联，计算时要考虑进去。

4. 从按下到读到：一次完整的信号链路拆解

4.1 硬件链路：按键、电阻、引脚、PCB

假设我们做一个最典型的低电平有效按键电路：按键一端接 PA0，另一端接 GND，PA0 配置为GPIO_Mode_IPU。那么整个链路是这样的：

• 按键松开时，PA0 通过内部上拉电阻连到 VDD，引脚电压接近 3.3V，施密特触发器输出高，IDR 对应位为 1。
• 按键按下时，PA0 直接连到 GND，内部上拉电阻被短路到地，引脚电压接近 0V，施密特触发器输出低，IDR 对应位为 0。
• 按键松开瞬间，引脚电压从 0V 往 3.3V 爬升，爬升速度由内部上拉电阻和引脚等效电容决定。内部上拉约 40k，引脚电容加走线电容约 10pF，时间常数约 400ns，远小于机械抖动时间，所以电气上升很快，主要问题还是机械抖动。

这里有个细节：按键按下时，内部上拉电阻上会有电流流过。3.3V 除以 40k，大约 82.5 微安。这个电流不大，但如果你的设备是电池供电，而且按键被长时间按住，就要算进功耗预算。换成 100k 外部上拉，电流降到 33 微安；换成 1M，降到 3.3 微安，但抗干扰能力也大幅下降。这就是工程上的取舍。

4.2 采样链路：APB2 时钟、采样周期、IDR 更新

GPIO 输入采样依赖 APB2 时钟。以 STM32F103 为例，GPIOA 挂在 APB2 总线上，如果系统时钟 72MHz，APB2 不分频，那么 GPIO 采样时钟就是 72MHz，采样周期约 13.9ns。这意味着 IDR 每 13.9ns 就可能更新一次。你代码里读一次 IDR，读到的是最近一次采样的结果，但两次读之间可能已经过了很多个采样周期。

这带来两个实际影响。第一，软件消抖的延时时间要远大于采样周期。你延时 10ms 再读，这 10ms 里 IDR 已经更新了约 72 万次，你读到的只是最后一次。第二，如果干扰脉冲极短，可能被采样到也可能不被采样到。比如一个 5ns 的尖峰，如果刚好落在采样窗口外，就不会影响 IDR；如果落在窗口内，就会被锁存。这也是为什么硬件消抖（加电容）和软件消抖要配合使用。

有些朋友会问：能不能通过降低 APB2 时钟来减少采样？可以，但没必要，而且会影响其他外设。更实际的做法是在软件里做多次采样取一致值，或者加 RC 滤波。

4.3 软件链路：GPIO_ReadInputDataBit 的调用代价

GPIO_ReadInputDataBit是标准库函数，它内部做了参数检查、按位与、返回。调用一次大概几十个时钟周期。如果你在中断里高频调用，或者在一个紧密循环里反复读，累积起来也不少。更高效的做法是直接读 IDR：

if ((GPIOA->IDR & GPIO_Pin_0) == 0) { // 按键按下 }

这样省去函数调用开销，但可读性略差。对于大多数应用，标准库函数完全够用。真正需要注意的是读的时机。如果你在定时器中断里每 1ms 读一次，那没问题；如果你在主循环里读，而主循环里有个延时 500ms 的操作，那按键响应就会很迟钝。所以按键扫描最好放在定时器中断或者独立的任务里，保证扫描周期稳定。

5. 按键消抖：为什么你读到的值会跳

5.1 机械抖动的真实波形

我用示波器抓过很多次按键波形。一个普通的 6x6 轻触按键，按下时触点闭合，波形从高电平掉到低电平，但并不是干净的一步到位。在 1ms 到 5ms 内，波形会在高低之间弹跳好几次，每次弹跳持续几十微秒到几百微秒。松开时同样有抖动。不同按键的抖动特性差别很大，便宜的按键可能抖 10ms 以上，好的按键可能只有 1ms。

如果你在抖动期间读 IDR，读到的值可能是 1、0、1、0 随机变化。这就是为什么不加消抖的按键代码，偶尔会一次按下被识别成多次。这不是代码逻辑错，是物理世界本来就这样。

5.2 软件消抖的三种写法与取舍

最常见的软件消抖是“延时再读”：

if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) == 0) { delay_ms(10); if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) == 0) { // 确认按下 } }

这种写法简单，但delay_ms会阻塞 CPU，期间干不了别的事。如果主循环里还有其他任务，响应会变差。

第二种是“定时扫描 + 状态机”。每 5ms 或 10ms 扫描一次按键，连续几次读到相同值才确认状态变化。这种不阻塞，适合多按键和复杂逻辑。状态机通常包含“空闲”“消抖中”“按下确认”“等待释放”几个状态。

第三种是“计数滤波”。每次扫描如果读到低，计数器加一；读到高，计数器减一；计数器超过阈值认为按下，低于阈值认为释放。这种对短脉冲干扰有很好的抑制效果，但响应速度略慢。

我个人的习惯是：按键少、逻辑简单用延时消抖；按键多、有低功耗要求用定时扫描状态机。不管哪种，消抖时间不要照抄 10ms，要根据实际按键手册和实测调整。有些按键 5ms 就够，有些要 20ms。

5.3 硬件消抖：一个电容一个电阻的事

软件消抖不占额外元件，但占用 CPU 和代码空间。硬件消抖在按键两端并联一个 0.1uF 电容，再配合上拉电阻，就能把抖动滤掉。原理是电容充电放电需要时间，触点弹跳产生的高频脉冲被电容吸收，引脚电压变化变得平缓。

计算一下：上拉 10k，电容 0.1uF，时间常数 1ms。触点抖动通常在 1ms 内，电容能让电压不会快速跳变，施密特触发器就不会频繁翻转。如果抖动更久，可以加大电容到 1uF，时间常数 10ms，但按键响应也会变慢，按下后要等一会儿才被识别。

硬件消抖的优点是彻底、不占 CPU，缺点是增加元件、增加成本、增加 PCB 面积。对于消费类产品，通常软件消抖就够了；对于工业设备或者干扰严重的场景，硬件消抖更稳妥。

6. 那些年我踩过的 GPIO 输入坑

6.1 坑一：时钟没开，读出来永远是 0

这个坑太经典了。STM32 的外设时钟默认是关闭的，你不开 GPIOA 的时钟，写配置寄存器没反应，读 IDR 也永远是 0。标准库要调用RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE)，HAL 库要调用__HAL_RCC_GPIOA_CLK_ENABLE()。我见过有人调试半天，最后发现是时钟没开。更隐蔽的是，有些引脚复用了，你以为是 GPIO，其实被其他外设占着，这时候读 IDR 也不对。

6.2 坑二：引脚被复用功能占用

STM32 很多引脚默认是复用功能，比如 PA13、PA14 是 SWD 调试口，PA9、PA10 是串口。如果你把按键接到这些引脚上，又不关闭复用功能，GPIO 输入可能读不到正确值。解决办法是查数据手册的引脚定义表，确认该引脚在复位后的默认功能，必要时用GPIO_PinRemapConfig重映射，或者换一个普通 GPIO。

6.3 坑三：浮空输入接按键，松开时乱跳

前面讲过，浮空输入没有内部上下拉，引脚悬空时电压不确定。如果你按键一端接引脚、一端接地，配成浮空输入，按下时读到 0，松开时引脚悬空，读到什么全看运气。正确的做法是配成上拉输入，或者外部加上拉电阻。这个坑在新手里非常普遍，因为有些教程只讲“按键接 GPIO”，没讲模式选择。

6.4 坑四：上拉输入读按键，按下时读到 1

这个坑通常是电路接反了。上拉输入默认高，按下应该读到低。如果你按下读到 1，松开读到 0，说明按键另一端接的是 VCC 而不是 GND。这时候要么改电路，要么把模式改成下拉输入。还有一种可能是按键焊接不良，或者引脚定义搞错了。

6.5 坑五：长线按键引入干扰，偶尔误触发

设备面板上的按键通过排线连接到主板，线长 20cm 以上，附近有电机。内部上拉 40k，干扰耦合到线上，引脚电压瞬间被拉低，IDR 读到 0，软件以为按键按下。解决办法是加外部强上拉（4.7k），同时在引脚和地之间加 0.1uF 电容，软件上做多次采样确认。如果还不行，考虑用屏蔽线或者把按键扫描改成差分输入。

6.6 常见问题速查表

7. 一个可直接抄的按键输入实现

7.1 硬件连接与模式选择

以 PA0 接按键为例，推荐电路：按键一端接 PA0，另一端接 GND，PA0 配置为GPIO_Mode_IPU。如果走线超过 10cm，在 PA0 和 VCC 之间加一个 4.7k 外部上拉，PA0 和 GND 之间加一个 0.1uF 电容。这样硬件上已经有不错的抗干扰能力。

模式配置代码（标准库）：

GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure);

HAL 库版本：

__HAL_RCC_GPIOA_CLK_ENABLE(); GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = GPIO_PIN_0; GPIO_InitStruct.Mode = GPIO_MODE_INPUT; GPIO_InitStruct.Pull = GPIO_PULLUP; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

注意 HAL 库里GPIO_MODE_INPUT配合GPIO_PULLUP就等价于标准库的GPIO_Mode_IPU。

7.2 定时扫描状态机代码

下面是一个不阻塞的按键扫描实现，放在 1ms 定时器中断里调用：

typedef enum { KEY_IDLE = 0, KEY_DEBOUNCE, KEY_PRESSED, KEY_RELEASE } KeyState; static KeyState keyState = KEY_IDLE; static uint16_t debounceCnt = 0; static uint8_t keyPressedFlag = 0; void Key_Scan(void) { uint8_t pinLevel = GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0); switch (keyState) { case KEY_IDLE: if (pinLevel == 0) { keyState = KEY_DEBOUNCE; debounceCnt = 0; } break; case KEY_DEBOUNCE: if (pinLevel == 0) { debounceCnt++; if (debounceCnt >= 10) { // 10ms 消抖 keyState = KEY_PRESSED; keyPressedFlag = 1; } } else { keyState = KEY_IDLE; } break; case KEY_PRESSED: if (pinLevel == 1) { keyState = KEY_RELEASE; debounceCnt = 0; } break; case KEY_RELEASE: if (pinLevel == 1) { debounceCnt++; if (debounceCnt >= 10) { keyState = KEY_IDLE; } } else { keyState = KEY_PRESSED; } break; } } uint8_t Key_IsPressed(void) { if (keyPressedFlag) { keyPressedFlag = 0; return 1; } return 0; }

这段代码每 1ms 调用一次，消抖时间 10ms，不阻塞主循环。Key_IsPressed返回 1 表示有一次确认的按下事件。你可以根据实际按键调整debounceCnt阈值。

7.3 参数计算与调整依据

消抖时间怎么定？我的经验是：先看按键手册的抖动时间，通常标称 5ms 以内；然后实测，用示波器抓 10 次按下波形，取最长抖动时间；最后留 2 倍余量。比如实测最长 4ms，消抖设 8ms 到 10ms。如果按键使用环境温度变化大，余量再放大。

扫描周期怎么定？1ms 是常用值，既能及时响应，又不会太占 CPU。如果系统低功耗，可以降到 5ms 或 10ms，但消抖计数要相应调整。比如 5ms 扫描，消抖 2 次就是 10ms。

上拉电阻怎么选？内部上拉够用就不加外部。如果加外部，4.7k 到 10k 是甜点区。太小费电，太大抗干扰差。如果按键线很长，可以降到 2.2k，但要确认按键触点能承受的电流。

8. 读到的值不对时，怎么一步步排查

8.1 先量电压，再看寄存器，最后查代码

排查 GPIO 输入问题，我习惯按这个顺序：先量引脚电压，再看 IDR 寄存器，最后查代码配置。为什么？因为电压是物理层，寄存器是硬件采样层，代码是软件层。从下往上查，能快速定位问题在哪一层。

量电压：按键松开时，引脚对地电压应该是 VCC 附近；按下时应该是 0V 附近。如果松开时电压在中间，说明上拉不够或者有干扰；如果按下时电压不是 0，说明接地不良或者有串联电阻。

看 IDR：在调试器里直接看GPIOA->IDR的值，和量到的电压对比。如果电压是高但 IDR 是 0，说明模式配错了或者引脚被复用；如果电压在中间且 IDR 跳变，说明干扰或者浮空。

查代码：确认时钟开了、模式对了、引脚号对了、没有其他外设占用。这一步最花时间，但前两步能帮你排除大部分硬件问题。

8.2 用调试器实时观察 IDR

Keil 和 STM32CubeIDE 都支持在调试时实时查看外设寄存器。以 Keil 为例，进入调试模式后，打开 System Viewer，找到 GPIOA，就能看到 IDR 的实时值。你按按键，看 IDR 对应位是否变化。如果变化但代码没反应，说明代码读的引脚不对；如果不变，说明硬件或配置有问题。

这个手段比打印串口快得多，也不影响实时性。我调试按键问题时，第一步就是开调试器看 IDR。

8.3 常见误判：把干扰当成按键

有时候你看到 IDR 偶尔跳一下，以为是按键抖动，其实是干扰。区分方法是：按键抖动发生在按下和松开的瞬间，持续时间短；干扰可能发生在任何时候，和按键动作无关。你可以不碰按键，观察一段时间 IDR，如果它自己跳，那就是干扰。解决办法是加硬件滤波、改上拉、远离干扰源。

还有一种误判是电源波动。如果 VCC 不稳，上拉电压也跟着波动，可能跨过施密特阈值。用示波器看 VCC 和引脚电压，如果 VCC 有纹波，先解决电源问题。

9. 最后分享几个实操小技巧

第一个技巧：按键扫描函数不要放在主循环里裸调，放在定时器中断里。主循环里如果有延时或者阻塞操作，按键响应会不稳定。定时器中断保证扫描周期恒定，消抖计数才有意义。

第二个技巧：多按键时，把每个按键的状态机封装成结构体数组。这样增加按键只需要加一个数组元素，不用复制粘贴代码。结构体里放状态、计数器、引脚号、端口号，扫描函数遍历数组即可。

第三个技巧：调试阶段可以把按键状态通过串口打印出来，但正式版本要去掉。串口打印会占用时间，影响实时性。如果一定要保留，用 DMA 或者环形缓冲，别在中断里直接printf。

第四个技巧：如果按键需要长按和短按识别，在状态机里加一个计时器。按下确认后开始计时，释放时根据计时值判断短按还是长按。长按还可以做连发，每隔一定时间触发一次。

第五个技巧：低功耗场景下，按键引脚可以配置成中断唤醒，平时不扫描。STM32 的 EXTI 支持上升沿、下降沿、双边沿触发，按键按下时产生中断，唤醒 MCU。唤醒后再启动扫描确认。这样待机电流可以降到微安级。但要注意，中断唤醒后要消抖，否则抖动会触发多次中断。

我在实际项目里遇到过一次按键问题，折腾了很久：板子上有个按键，单独测试正常，装到金属外壳里就偶尔误触发。后来发现是金属外壳和按键引脚之间有寄生电容，人手触摸外壳时引入工频信号。解决办法是在按键引脚和地之间加 0.1uF 电容，同时把内部上拉改成外部 4.7k 上拉，问题就消失了。这个经验告诉我，GPIO 输入读到的值，从来不只是代码的事，它是电路、芯片、软件三者共同作用的结果。你把这三层都理清楚，按键问题就不再是玄学。