STM32 HAL库串口重定向printf的实战与避坑指南

1. 为什么需要串口重定向printf

在嵌入式开发中，调试是一个绕不开的话题。想象一下，你正在开发一个基于STM32的智能家居控制器，需要实时监控温湿度传感器的数据。如果没有合适的调试手段，你可能只能通过LED灯的闪烁频率来猜测程序运行状态，这种感觉就像在黑暗中摸索前进。

printf函数是我们最熟悉的老朋友了，在桌面编程中，它能够将信息直接输出到屏幕上。但在STM32这样的嵌入式系统中，默认情况下printf是无处输出的。这就是为什么我们需要重定向printf到串口——让这个老朋友通过串口与我们"对话"。

我刚开始接触STM32的时候，也曾经用笨办法调试：在每个关键节点设置不同的LED灯状态，然后拿着小本本记录每种闪烁模式对应的程序状态。直到有一天看到同事轻松地用printf输出调试信息，我才恍然大悟：原来嵌入式调试可以这么优雅！

重定向printf后，你可以在代码中任意位置添加打印语句，实时查看变量值、程序流程、错误信息等。无论是传感器数据异常还是逻辑判断出错，都能通过串口助手一目了然。这种调试效率的提升，对于项目进度来说简直是雪中送炭。

2. 环境准备与CubeMX配置

工欲善其事，必先利其器。在开始重定向printf之前，我们需要先搭建好开发环境。我推荐使用STM32CubeMX + Keil MDK的组合，这也是大多数STM32开发者首选的工具链。

首先打开CubeMX，创建一个新项目，选择你正在使用的STM32型号。以常见的STM32F103C8T6为例，我们需要配置以下几个关键部分：

时钟配置：这是很多新手容易踩坑的地方。STM32的串口波特率依赖于系统时钟，如果时钟配置不正确，会导致通信失败。建议先使用默认的内部时钟（HSI），等调试通过后再尝试使用外部晶振。

串口配置：找到USART1（或其他你想使用的串口），将其模式设置为"Asynchronous"。基本参数建议如下：

• 波特率：115200
• 数据位：8
• 停止位：1
• 校验位：None
• 硬件流控制：None

引脚分配：USART1默认使用PA9作为TX引脚，PA10作为RX引脚。如果你需要重映射到其他引脚，比如PB6/PB7，记得在"Alternate"选项中正确配置。

生成代码：在Project Manager中设置好项目名称和路径，选择MDK-ARM作为Toolchain/IDE。关键的一步是在Code Generator中勾选"Generate peripheral initialization as a pair of '.c/.h' files per peripheral"，这样会让代码结构更清晰。

完成配置后点击GENERATE CODE，CubeMX会自动生成初始化代码。我用这个流程配置过几十个项目，从未失手过。记得在第一次使用新芯片时，先烧录一个简单的LED闪烁程序，确认开发环境工作正常。

3. 方法一：完整的retarget.c方案

这是我最推荐的方法，虽然步骤稍多，但一劳永逸。我在实际项目中发现，这种方法稳定性最好，而且支持完整的标准库功能。

3.1 创建retarget文件

在Src文件夹下新建retarget.c文件，输入以下代码：

#include <_ansi.h>
#include <_syslist.h>
#include <errno.h>
#include <sys/time.h>
#include <sys/times.h>
#include <limits.h>
#include <signal.h>
#include "../Inc/retarget.h"
#include <stdint