STM32调试利器：printf跨编译器串口重定向实战指南-CSDN博客

1. 为什么说printf是STM32调试的“瑞士军刀”？

如果你刚开始玩STM32，是不是经常被调试搞得头大？点个灯、读个传感器，代码跑起来没反应，或者数据死活不对，这时候你怎么办？是疯狂地插拔杜邦线，用逻辑分析仪抓波形，还是干脆在代码里到处写HAL_UART_Transmit，把数据一股脑发到串口助手，然后在一堆乱码里找线索？

我刚开始做项目那会儿，就是这么干的。调试一个简单的温湿度传感器，为了看一个浮点型的温度值，我写了十几行代码来拆分数据、发送字符串，效率低不说，还容易出错。直到后来，一位老工程师跟我说：“别折腾了，把printf用起来，你那些麻烦事，它一行代码就搞定。” 我当时将信将疑，试了一下，从此打开了新世界的大门。

那么，这个在电脑上司空见惯的printf，在STM32这种资源紧张的MCU上，到底能干嘛？简单说，它就是你最趁手的“调试信息输出工具”。你想实时查看一个变量的值？printf("Current Temp: %.2f\r\n", temperature);。你想知道程序执行到哪个分支了？printf("[INFO] Enter function A.\r\n");。你想格式化输出一组复杂的结构体数据？printf也能轻松办到。它把繁琐的数据转换和发送封装起来，让你能用最熟悉、最直观的方式，把芯片内部的状态“说”给你听。

但问题来了，STM32的库函数里并没有直接给你一个能用的printf。芯片上的串口（UART）和电脑上的控制台（Console）是两套完全不同的东西。printf默认是往标准输出（通常是屏幕）打印的，我们需要做一个“重定向”，告诉它：“嘿，别往屏幕打了，把字符都送到串口1，通过USB转串口线发给我的电脑。” 这个过程，就是串口重定向。

掌握了它，就等于给你的STM32开发装备上了一把“瑞士军刀”。无论是MDK（Keil）还是GCC（比如STM32CubeIDE、VSCode+PlatformIO），你都能用同一种优雅的方式输出调试信息，极大提升开发效率。接下来，我就手把手带你，在两大主流编译器环境下，把这把“刀”磨锋利了。

2. 动手前的准备：理解核心与搭建环境

在开始写代码之前，我们得先搞清楚printf重定向到底是怎么一回事。别被“重定向”这个词吓到，它的本质非常简单：劫持。

想象一下，printf函数内部其实是个“流水线工人”，它的工作就是把你要打印的字符串、数字，一个一个字符地处理、打包。但它自己并不知道最终要把这些“包裹”送到哪里。在电脑上，操作系统早就安排好了，默认送到屏幕。在STM32上，没有操作系统，这个“送货地址”就需要我们来指定。

printf底层最终会调用一个非常基础的“送货员”函数，去完成发送单个字符的实际操作。在不同的编译环境下，这个“送货员”的名字不一样。我们的任务就是：自己写一个同名的“送货员”函数，替换掉编译器默认提供的那个（或者提供一个默认没有的），在这个自定义函数里，我们用STM32的HAL库或者标准库的串口发送函数，把字符通过UART发出去。这样一来，所有调用printf的请求，就都被“劫持”到我们的串口上了。

这就是最核心的思想。理解了这一点，后面的代码就是填空了。

环境准备方面，你需要：

一块STM32开发板：最常见的就是STM32F1系列的“蓝色小药丸”（BluePill）或者F4系列的Discovery板，它们都自带USB转串口芯片，方便连接电脑。
一个串口调试助手：电脑端用来接收和显示数据的软件。像SecureCRT、MobaXterm、Putty，或者国产的XCOM、SSCOM都非常好用。确保波特率、数据位、停止位等参数和你的代码配置一致（通常用115200-8-N-1）。
工程基础：一个能正常编译、下载、运行的STM32工程。无论是用STM32CubeMX生成，还是自己手动搭建的都可以。工程里需要已经正确配置好了一个UART（比如USART1），并且初始化代码能正常工作。你可以先写个简单的测试，用HAL_UART_Transmit发送一个字符串“Hello World”到串口助手，确保硬件链路是通的。