1. 从零开始理解HAL库的GPIO操作

搞嵌入式开发，尤其是玩STM32的，HAL库是绕不开的一道坎。很多朋友从标准库转过来，或者直接上手HAL，面对那一堆结构体和函数，总觉得有点“隔靴搔痒”，不如直接操作寄存器来得痛快。但说实话，当你项目复杂度上来，或者需要快速移植、维护代码时，HAL库的统一性和抽象能力优势就体现出来了。今天咱们不聊大道理，就扎扎实实地把HAL库里最基础、最常用的GPIO模块给掰开揉碎了讲清楚。我会结合自己调板子时踩过的坑，告诉你那些数据手册里不会写的细节，比如为什么你的推挽输出驱动能力不够，上下拉电阻到底什么时候该用，以及如何优雅地实现一个按键消抖。目标很简单：看完这篇，你能像操作标准库一样熟练且自信地使用HAL库的GPIO功能，并且知其然，更知其所以然。

2. GPIO基础与HAL库设计哲学

2.1 GPIO到底是什么？不仅仅是“开”和“关”

GPIO，通用输入输出端口，听起来很简单，就是一根能被程序控制成高电平或低电平的引脚。但在实际硬件和HAL库的抽象里，它复杂得多。一颗STM32的GPIO引脚，背后可能连着输出驱动器、输入缓冲器、上下拉电阻、复用功能选择器等多个物理单元。HAL库的作用，就是用软件结构体（GPIO_InitTypeDef）和一系列函数（HAL_GPIO_Init,HAL_GPIO_WritePin等），把这些硬件细节封装起来，让你通过配置几个参数就能安全、高效地控制它们。

这里有个关键点：HAL库的配置是“声明式”的。你不需要关心具体是哪一组寄存器（比如GPIOA->MODER）的哪一位被置1了，你只需要告诉库：“我要把PA5配置成推挽输出，高速模式，无上下拉”。这种抽象的好处是代码可读性极高，而且在不同系列的STM32芯片间移植时，通常只需要关心引脚定义是否一致，底层寄存器差异由HAL库处理。但坏处是，如果你不理解这些配置参数对应的硬件行为，一旦出问题，调试起来会像在黑盒里摸象。

2.2 HAL库GPIO模块的核心结构体解析

一切GPIO操作的起点，都是GPIO_InitTypeDef这个结构体。我们把它拆开看：

typedef struct { uint32_t Pin; // 指定要配置的引脚（如 GPIO_PIN_5） uint32_t Mode; // 工作模式（输入、输出、复用、模拟） uint32_t Pull; // 上拉/下拉电阻配置 uint32_t Speed; // 输出速度（低速、中速、高速、超高速） } GPIO_InitTypeDef;

• Pin：这个简单，用GPIO_PIN_x宏指定，也支持或运算同时配置多个引脚（如GPIO_PIN_5 | GPIO_PIN_6）。
• Mode：这是重中之重，决定了引脚的根本行为。主要有四大类：
  • GPIO_MODE_INPUT：输入模式。引脚状态由外部电路决定，MCU读取其电平。
  • GPIO_MODE_OUTPUT_PP：推挽输出模式。这是最常用的输出模式，能主动输出高电平（接近VDD）和低电平（接近GND），驱动能力较强。
  • GPIO_MODE_OUTPUT_OD：开漏输出模式。它只能主动拉低到GND，高电平状态需要外部上拉电阻来实现。常用于I2C总线等“线与”逻辑场合。
  • GPIO_MODE_AF_PP/GPIO_MODE_AF_OD：复用推挽/开漏输出。当引脚用于串口、SPI等片上外设时，需要配置为此模式，信号由外设模块产生。
  • GPIO_MODE_ANALOG：模拟模式。当引脚用作ADC输入或DAC输出时，必须配置为此模式，此时内部的数字电路被断开，以减少干扰。
• Pull：上拉/下拉配置。GPIO_NOPULL（浮空）、GPIO_PULLUP（上拉）、GPIO_PULLDOWN（下拉）。这里有个大坑：对于输出模式，很多工程师会忽略这个配置，认为输出模式不需要上下拉。但在引脚刚初始化完成、还未输出确定电平的瞬间，或者配置为开漏输出但外部未加上拉时，上下拉电阻能提供一个确定的默认状态，避免引脚悬空导致的不稳定和功耗增加。我的经验是，对于数字输出引脚，如果没有特殊要求，习惯性配置一个下拉（GPIO_PULLDOWN）是个好习惯，能让它在初始化后默认为低电平，更安全。
• Speed：输出速度。这个参数控制的是引脚电平翻转的压摆率（Slew Rate）。速度设得越高，引脚从0变到1（或1变到0）的速度越快，边沿越陡峭。但这会带来两个副作用：一是功耗增加，二是产生的电磁干扰（EMI）更强。所以，不是所有情况都要用“超高速”。驱动LED、继电器这种慢速器件，用低速（GPIO_SPEED_FREQ_LOW）就够了；驱动高速SPI通信或产生PWM波，可能需要高速（GPIO_SPEED_FREQ_HIGH）甚至超高速（GPIO_SPEED_FREQ_VERY_HIGH）。盲目选用最高速度，可能会让你的板子噪声超标，甚至影响自身ADC的采样精度。

注意：GPIO_MODE_INPUT模式下，Speed参数是不起作用的，因为输入模式不涉及主动驱动。但HAL库的API要求你填，通常填个默认值即可。

3. 输出模式深度剖析与实战配置

3.1 推挽输出 vs. 开漏输出：原理与选型指南

推挽输出和开漏输出的区别，是面试常考题，更是实际选型的依据。你可以把它们想象成两种不同的开关电路。

推挽输出就像一对“推”和“挽”的搭档。内部有两个MOS管，一个连接VDD（高电平），一个连接GND（低电平）。当输出1时，上管导通，下管关闭，引脚被“推”到高电平；当输出0时，上管关闭，下管导通，引脚被“挽”到低电平。任何时候，引脚都被一个MOS管强有力地拉到确定的电源轨上，所以驱动能力强，电平稳定，是驱动LED、蜂鸣器、继电器等负载的首选。

开漏输出则只有一个连接到GND的MOS管（下管）。当输出0时，下管导通，引脚被拉低；当输出1时，下管关闭，引脚相当于断开（高阻态）。此时，引脚的电平完全由外部电路决定。如果外部什么都没接，它就是悬空的，电平不确定。因此，开漏输出必须配合外部上拉电阻使用，才能输出高电平。

为什么需要这么“麻烦”的模式？主要三个用途：

1. 电平转换：假设MCU是3.3V供电，但需要与一个5V器件通信。如果使用推挽输出，高电平只有3.3V，可能无法被5V系统识别为高。使用开漏输出，外部上拉到5V，当MCU输出1（释放）时，引脚就被拉到了5V，完美实现电平匹配。
2. “线与”功能：在I2C总线上，多个设备可以同时挂载。如果任何一个设备将总线拉低（输出0），整条线就是低电平。只有所有设备都释放（输出1），总线才被上拉电阻拉高。这种逻辑“与”的关系，用推挽输出是无法实现的，因为推挽输出的高电平会“打架”。
3. 驱动大电流负载（有时）：开漏输出可以外接一个上拉电阻到更高的电压，并通过一个晶体管或MOS管来驱动负载，MCU只负责控制通断，不直接提供大电流。

实战配置示例：驱动一个LED假设LED阴极接在PA5，阳极通过限流电阻接3.3V。

GPIO_InitTypeDef GPIO_InitStruct = {0}; __HAL_RCC_GPIOA_CLK_ENABLE(); // 第一步，永远记得先使能时钟！ GPIO_InitStruct.Pin = GPIO_PIN_5; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; // 推挽输出，主动驱动 GPIO_InitStruct.Pull = GPIO_PULLDOWN; // 初始化后默认为低，LED灭 GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW; // LED闪烁，低速足够 HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); // 点亮LED HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET); // 实际上，对于LED，高电平点亮还是低电平点亮，取决于你的硬件电路。

3.2 输出速度配置的陷阱与EMI考量

输出速度的配置，在CubeMX里点一下下拉菜单很简单，但背后的影响需要仔细权衡。速度等级本质上是通过控制输出驱动器的电流能力来实现的，电流越大，对寄生电容的充电速度越快，边沿就越陡。

我曾在一个电机控制项目里，用高速PWM驱动MOS管。最初为了追求完美的方波，把所有PWM引脚都设成了GPIO_SPEED_FREQ_VERY_HIGH。结果发现系统的ADC采样值偶尔会有规律的毛刺，导致电流环控制不稳定。用示波器抓取PWM信号和ADC输入引脚附近的噪声，发现PWM的上升沿和下降沿引发了强烈的振铃。后来把速度降到GPIO_SPEED_FREQ_MEDIUM，虽然PWM边沿稍微变缓了一点（从几纳秒变成了十几纳秒），但对电机控制来说完全足够，而ADC的采样噪声显著降低，系统稳定性大增。

给你的建议是：

• 低速 (LOW)：适用于GPIO控制指示灯、继电器，频率低于100kHz的信号。
• 中速 (MEDIUM)：通用选择，适用于大多数USART、I2C（标准模式）、普通定时器中断触发的IO操作。
• 高速 (HIGH)：适用于SPI（几MHz到十几MHz）、SDIO、高速USART、以及电机控制PWM（kHz级别）等。
• 超高速 (VERY_HIGH)：仅用于真正需要极快边沿的场合，如高速SDIO（SD卡）、DCMI（摄像头接口）、以及超过50MHz的FSMC等。使用时务必做好PCB布局的阻抗控制和电源去耦。

一个简单的原则：在满足时序要求的前提下，尽量选用低的速度等级。这能降低功耗、减少噪声，何乐而不为？

4. 输入模式、上下拉电阻与按键处理实战

4.1 输入模式与上下拉电阻的正确使用

输入模式看似简单，但配置不当是很多诡异问题的源头。当引脚配置为GPIO_MODE_INPUT时，MCU内部会连接一个施密特触发器（ Schmitt Trigger）作为输入缓冲器，它将模拟的电压信号转换成干净的数字信号。这时，Pull参数就至关重要了。

• 浮空输入 (GPIO_NOPULL)：引脚内部既不接上拉电阻也不接下拉电阻。此时引脚电平完全由外部电路决定。如果外部是开路（比如一个未按下的按键），引脚就处于悬空状态，其电平是随机的，会受到电磁干扰影响而不断翻转。这会导致MCU读取到毫无意义的、快速变化的电平。除非你确信外部电路始终能提供一个确定的驱动（比如接了传感器输出），否则不要使用浮空输入。
• 上拉输入 (GPIO_PULLUP)：内部通过一个约40kΩ（具体值因型号而异）的电阻连接到VDD。当外部没有驱动时，引脚会被弱拉到高电平。这是连接按键到地（按键另一端接GND）的标准接法。按键未按下时，读到的值是1（高电平）；按键按下时，引脚被直接拉到地，读到的值是0（低电平）。
• 下拉输入 (GPIO_PULLDOWN)：内部通过电阻连接到GND。当外部没有驱动时，引脚被弱拉到低电平。适用于按键另一端接VDD的电路。

核心要点：对于输入引脚，特别是连接机械开关（按键、拨码开关）、或可能断开连接的传感器时，必须使用上拉或下拉电阻来提供一个确定的默认状态，绝对避免浮空。

4.2 按键消抖：软件实现与高级技巧

机械按键在闭合和断开的瞬间，由于金属弹片的物理特性，会产生一系列快速的、毫秒级别的抖动，而不是一个干净的边沿。如果不处理，一次按键会被误判为多次按下。

最简单的消抖方法是延时采样。但HAL_Delay()是阻塞的，在延时期间CPU什么都干不了，这在实时系统中是不可接受的。下面分享一个基于状态机的非阻塞消抖方法，这是我项目中常用的：

// 按键状态机定义 typedef enum { BTN_STATE_RELEASED, // 按键释放（稳态） BTN_STATE_DEBOUNCE, // 消抖中（暂态） BTN_STATE_PRESSED // 按键按下（稳态） } ButtonState_t; // 按键数据结构 typedef struct { GPIO_TypeDef* port; uint16_t pin; ButtonState_t state; uint32_t lastCheckTime; uint32_t debounceTimeout; // 消抖时间，如20ms void (*onPressed)(void); // 按下回调函数 void (*onReleased)(void); // 释放回调函数 } Button_t; // 非阻塞按键扫描函数，需在定时器中断或主循环中定期调用（如每5ms一次） void Button_Process(Button_t* btn) { uint8_t currentLevel = HAL_GPIO_ReadPin(btn->port, btn->pin); uint32_t currentTime = HAL_GetTick(); switch (btn->state) { case BTN_STATE_RELEASED: if (currentLevel == 0) { // 假设低电平为按下（上拉接法） btn->state = BTN_STATE_DEBOUNCE; btn->lastCheckTime = currentTime; } break; case BTN_STATE_DEBOUNCE: if (currentTime - btn->lastCheckTime >= btn->debounceTimeout) { // 消抖时间到，再次确认电平 if (HAL_GPIO_ReadPin(btn->port, btn->pin) == 0) { btn->state = BTN_STATE_PRESSED; if (btn->onPressed != NULL) { btn->onPressed(); // 触发按下事件 } } else { // 是抖动，回到释放状态 btn->state = BTN_STATE_RELEASED; } } break; case BTN_STATE_PRESSED: if (currentLevel == 1) { // 按键释放 btn->state = BTN_STATE_DEBOUNCE; btn->lastCheckTime = currentTime; } break; } // 处理从按下到释放的消抖（类似逻辑，可扩展） // ... 为了简洁，此处省略释放消抖的完整代码，结构与按下消抖对称 }

这个状态机的优点在于，它将消抖逻辑分散到了多个时间片里执行，Button_Process函数执行得非常快，不会阻塞系统。你只需要在一个定时中断或主循环中定期调用它即可。debounceTimeout一般设为20-50ms，可以根据按键的实际情况调整。

更进一步，你还可以在这个状态机里实现长按、短按、连按的检测，只需要在BTN_STATE_PRESSED状态下开始计时，根据按压时长触发不同的事件回调。

5. 复用功能与引脚重映射

5.1 何时及如何配置复用功能

当STM32的引脚用于片上外设，如USART的TX/RX、SPI的SCK/MOSI/MISO、I2C的SDA/SCL时，就需要将GPIO配置为复用模式。此时，引脚的控制权从GPIO寄存器转移给了对应的外设。你需要做两步：

1. 通过GPIO_InitTypeDef的Mode字段，将引脚配置为GPIO_MODE_AF_PP（复用推挽输出）或GPIO_MODE_AF_OD（复用开漏输出，用于I2C）。
2. 通过GPIO_PinAFConfig函数（或CubeMX自动生成）来选择具体的复用功能编号（AF）。这是关键！因为一个引脚可能对应多个复用功能。例如，PA9可以是USART1_TX，也可以是TIM1_CH2。你需要查阅芯片的数据手册（Datasheet）或引脚分配表（Pinout），找到正确的AF编号。

在CubeMX中，这个步骤是可视化的。当你把PA9分配给USART1_TX时，它会自动帮你完成上述配置。但在手动编写或修改代码时，千万别忘了AF配置。

// 手动配置PA9为USART1_TX（复用推挽输出） GPIO_InitTypeDef GPIO_InitStruct = {0}; __HAL_RCC_GPIOA_CLK_ENABLE(); __HAL_RCC_USART1_CLK_ENABLE(); // 别忘了使能外设时钟！ GPIO_InitStruct.Pin = GPIO_PIN_9; GPIO_InitStruct.Mode = GPIO_MODE_AF_PP; // 复用推挽 GPIO_InitStruct.Pull = GPIO_NOPULL; // 串口线通常外部有上下拉，内部可不配 GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; // 通信速率高，用高速 GPIO_InitStruct.Alternate = GPIO_AF7_USART1; // 关键！指定复用功能为USART1 HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

5.2 调试接口（SWD）引脚用作普通GPIO的注意事项

这是一个非常实际的需求。MCU的引脚资源紧张，而SWD调试接口（通常是PA13/SWDIO和PA14/SWCLK）在程序正常运行时可能用不到。很多人想把它当成普通GPIO来用，比如驱动一个LED或者读一个按键。

警告：这个操作有风险，需要严格按照步骤来。

1. 先解锁，再修改：SWD引脚在芯片复位后默认被分配为调试功能，并且受到写保护。直接配置GPIO是无效的。你需要先调用HAL_GPIO_DeInit()来解除初始化，但更关键的是，对于某些系列（如STM32F1），可能需要操作AFIO->MAPR寄存器来禁用SWD的复用功能。对于使用HAL库的新系列（如F4, L4），通常可以通过__HAL_AFIO_REMAP_SWJ_DISABLE()之类的宏来实现，但这会完全禁用JTAG/SWD接口，导致你无法再通过这个接口下载或调试程序！
2. 必须保留一种调试方式：绝对不要同时禁用SWD和JTAG。建议使用“SWD禁用JTAG”的模式（如果支持），这样至少还能用SWD接口。更好的做法是，在程序初始化最开始的地方，不要立即重映射这些引脚。而是通过一个存储在备份寄存器或Flash特定位置的标志位来决定。在开发阶段，这个标志位不清除，引脚保持为调试功能；在量产阶段，通过第一次上电运行的特殊代码来设置这个标志位并重启，之后引脚才作为GPIO使用。这样，万一量产程序有问题，你还能通过强制擦除整个Flash的方式恢复调试接口。
3. HAL库的便利性：对于STM32L4等系列，HAL库提供了相对清晰的接口。但即便如此，我也强烈建议你仔细阅读参考手册中关于“调试MCU配置寄存器（DBGMCU）”的章节，并先在一个小测试程序上验证，确认你还能在修改后重新下载程序，再进行正式开发。

6. 高级话题：GPIO模拟通信协议

6.1 GPIO模拟I2C：开漏输出与精确时序

当硬件I2C外设出现兼容性问题，或者引脚被占用时，用GPIO模拟（Bit-Banging）是一个可靠的备选方案。模拟I2C的核心在于两点：必须使用开漏输出模式，以及精确的时序控制。

为什么必须开漏？回顾I2C总线的“线与”特性。多个设备的数据线（SDA）和时钟线（SCL）都连接在一起。任何一个设备都可以拉低总线，但释放总线时必须是高阻态，由上拉电阻拉高。推挽输出无法实现“释放”这个状态，它会主动输出高电平，如果两个设备一个输出高一个输出低，就会发生电源短路。

模拟I2C的关键函数：

// 假设 SDA->PB9, SCL->PB8， 已配置为上拉开漏输出 #define I2C_SDA_PORT GPIOB #define I2C_SDA_PIN GPIO_PIN_9 #define I2C_SCL_PORT GPIOB #define I2C_SCL_PIN GPIO_PIN_8 // 设置SDA为输出方向（准备驱动） void SDA_OUT(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = I2C_SDA_PIN; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD; // 保持开漏 GPIO_InitStruct.Pull = GPIO_PULLUP; // 输出时也保持上拉，确保释放时为高 GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_MEDIUM; HAL_GPIO_Init(I2C_SDA_PORT, &GPIO_InitStruct); } // 设置SDA为输入方向（准备读取） void SDA_IN(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = I2C_SDA_PIN; GPIO_InitStruct.Mode = GPIO_MODE_INPUT; GPIO_InitStruct.Pull = GPIO_PULLUP; // 输入模式必须上拉！ HAL_GPIO_Init(I2C_SDA_PORT, &GPIO_InitStruct); } // 产生起始信号：SCL高电平期间，SDA产生一个下降沿 void I2C_Start(void) { SDA_OUT(); HAL_GPIO_WritePin(I2C_SDA_PORT, I2C_SDA_PIN, GPIO_PIN_SET); HAL_GPIO_WritePin(I2C_SCL_PORT, I2C_SCL_PIN, GPIO_PIN_SET); Delay_us(5); // 保持时间 HAL_GPIO_WritePin(I2C_SDA_PORT, I2C_SDA_PIN, GPIO_PIN_RESET); Delay_us(5); HAL_GPIO_WritePin(I2C_SCL_PORT, I2C_SCL_PIN, GPIO_PIN_RESET); // 钳住总线，准备发送数据 }

模拟I2C的难点在于时序，特别是建立时间（Setup Time）和保持时间（Hold Time）。不同的I2C器件要求不同，标准模式（100kHz）、快速模式（400kHz）和高速模式的时序要求差异很大。你需要根据数据手册，用Delay_us()或Delay_ns()（通过SysTick或定时器实现）来严格控制SCL高低电平的宽度以及SDA变化相对于SCL边沿的时间。一个常见的坑是，读取ACK时，在SCL低电平期间就改变了SDA的方向，这可能导致冲突。正确的做法是，在SCL低电平时准备好SDA方向，在SCL上升沿前稳定，在SCL高电平期间读取。

6.2 GPIO模拟单总线（如DS18B20）：严格依赖延时

像DS18B20这样的单总线器件，对时序的要求近乎苛刻。它没有时钟线，完全依靠数据线上电平的持续时间来区分“0”、“1”和复位脉冲。用HAL库模拟时，最大的挑战是函数调用本身带来的延时不确定性。

绝对不要用HAL_Delay()！它的精度是毫秒级的，而单总线协议要求的是微秒甚至纳秒级的精度。你必须使用精度更高的延时方法：

1. SysTick定时器：将SysTick配置为1us中断一次，用一个全局变量计数。但中断开销会影响精度。
2. 硬件定时器：使用一个基本定时器（如TIM6/TIM7）产生精确的微秒级延时，这是最可靠的方法。
3. NOP空指令循环：对于已知主频的MCU，可以写一个基于__NOP()或简单循环的延时函数。但这种方法受编译器优化和中断影响大，需要仔细校准。

// 一个基于循环的粗略微秒延时（需要根据CPU频率校准！） void Delay_us(uint16_t us) { uint32_t ticks = us * (SystemCoreClock / 1000000) / 5; // 粗略估算 while(ticks--) { __NOP(); } } // 向DS18B20写一位‘0’ void DS18B20_WriteBit0(void) { SET_DQ_LOW(); // 拉低总线 Delay_us(60); // 保持低电平60us（具体值查DS18B20手册） SET_DQ_HIGH(); // 释放总线 Delay_us(2); // 恢复时间 }

模拟单总线的代码必须极其精确，最好用逻辑分析仪或示波器抓取波形，与数据手册的时序图逐一比对。任何一点偏差都可能导致通信失败。

7. HAL库GPIO常见问题排查实录

7.1 问题速查表

7.2 调试心得：逻辑分析仪是你的好朋友

面对GPIO问题，尤其是时序相关的问题，万用表只能看静态电平，示波器看几个通道的波形也费劲。一个几十块钱的逻辑分析仪（配合上位机软件如PulseView/Saleae）能同时记录8路甚至更多信号，并以时间轴的形式清晰展示电平变化、脉冲宽度和协议解码（如UART, I2C, SPI），是调试数字通信和GPIO时序的神器。

例如，当你怀疑模拟I2C的时序不对时，用逻辑分析仪抓取SDA和SCL的波形，可以直观地看到起始信号、数据位、ACK位的宽度是否符合标准，一眼就能定位是哪个环节的延时出了问题。同样，对于按键抖动，你可以清晰地看到按下瞬间的那一串毛刺，从而验证你的消抖算法是否有效。

7.3 功耗考量：未用引脚的处理

在低功耗项目中，每一个微安都至关重要。未使用的GPIO引脚如果处理不当，可能会成为漏电的源头。最佳实践是：

• 将所有未使用的引脚配置为模拟输入模式（GPIO_MODE_ANALOG）。在这个模式下，内部的上下拉电阻和数字输入缓冲器都被断开，功耗最低。
• 如果芯片不支持（某些老型号），则配置为输出模式并输出一个固定电平（高或低），同时禁止上下拉。避免引脚悬空。
• 千万不要将未用引脚设置为浮空输入。

在CubeMX中，你可以在“Pinout & Configuration”标签页，右键点击未使用的引脚，选择“Enter User Label”并标记为“UNUSED”，然后在代码生成设置中，勾选“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”，这样它可能会为这些未用引脚生成一个统一的初始化函数，方便管理。但最稳妥的还是手动在main.c的初始化部分，遍历所有你确定不用的引脚，将其初始化为模拟模式。