开发STM32时，许多工程师常被一些表面现象误导，陷入调试困境。以下五大常见误区，几乎每个新手都会遇到，纠正它们可大幅提升开发效率。

误区一：时钟配置 = 波特率准确

错误认知：认为配置了波特率数值，通信就一定正常。

真相：STM32的USART波特率依赖于APB总线时钟（PCLKx），若主时钟（HSE/PLL）未正确配置，实际频率可能与理论值偏差数倍。

改正：使用CubeMX时务必检查时钟树，并通过HAL_RCC_GetPCLK1Freq()验证实际频率。

误区二：GPIO模式 = 功能自动生效

错误认知：配置GPIO为串口或PWM功能时，仅设置引脚模式即可。

真相：USART的TX/RX必须设置为复用功能（AF_PP/AF_OD），而非普通输入输出；PWM输出需使能TIM时钟并配置通道为输出模式。

改正：在CubeMX中明确选择复用模式，并验证HAL_GPIO_Init()的配置参数。

误区三：悬空引脚 = 无害

错误认知：未使用的GPIO或配置为外部中断的悬空引脚无需处理。

真相：悬空引脚电平漂移可能误触发中断（如外部中断），或导致接收信号异常。

改正：悬空中断引脚设置为上拉/下拉模式；未使用的RX引脚可加10kΩ上拉电阻。

误区四：HAL库函数 = 即插即用

错误认知：直接调用HAL库函数（如HAL_UART_Transmit()）无需考虑上下文。

真相：

阻塞式函数在中断中调用可能卡死程序；

部分HAL库存在底层BUG（如TIM捕获极性配置错误需手动修改宏）；

I2C等外设初始化顺序严格（如时钟使能必须在GPIO配置前）。

改正：中断中使用非阻塞函数（如HAL_UART_Transmit_IT()），并检查HAL库版本及初始化流程。

误区五：调试输出 = 任意使用printf

错误认知：在中断或高频调用中随意使用printf重定向到串口。

真相：printf占用时间长，若在串口接收中断中调用，会阻塞后续数据接收，导致数据丢失。

改正：中断函数内避免调用复杂输出函数，采用队列缓冲或标志位在主循环中处理数据。

误区六：GPIO驱动能力 = 无限输出

错误认知：GPIO可直接驱动多个LED或负载。

真相：STM32单个GPIO最大电流25mA，所有GPIO总电流最大限值也为25mA。超限可能导致芯片复位或损坏。

改正：驱动负载时加缓冲器（如三极管、驱动IC），并严格计算总电流。