STM32CubeMX实战：串口重定向与printf调试技巧

最新推荐文章于 2026-05-24 07:15:49 发布

原创

最新推荐文章于 2026-05-24 07:15:49 发布 · 498 阅读

1. 为什么你的printf在单片机上“哑巴”了？

很多朋友从C语言转到STM32开发时，遇到的第一个“水土不服”就是printf。在电脑上，一句printf("hello world")就能在控制台看到结果，但当你兴冲冲地把这段代码放到STM32工程里，编译、下载、运行，却发现串口调试助手一片空白，啥也没有。这感觉就像你对着一个朋友说话，他却完全听不见，是不是有点抓狂？

这背后的原因其实很简单。标准C库里的printf函数，它的输出目的地默认是“标准输出”（stdout），在电脑上就是你的命令行窗口或者IDE的终端。但我们的STM32单片机，它本质上是一块硅片，上面集成了CPU、内存和各种外设，它可没有一个现成的“屏幕”或“命令行”来接收这些字符。所以，printf函数虽然被成功编译、链接进了你的程序，但它发出的字符数据就像石沉大海，没有具体的硬件去接收和展现。

那怎么办呢？工程师们想出了一个非常巧妙的办法：重定向。简单来说，就是“狸猫换太子”。我们不改变printf函数本身的调用方式，但偷偷修改它底层最终负责输出单个字符的那个函数（通常是fputc或_write），让它不再把字符送往那个不存在的“标准输出”，而是通过我们指定的硬件——串口——发送出去。这样，我们就能用一根USB转串口线，在电脑的串口调试助手上，看到熟悉的调试信息了。这个过程，就是我们常说的“串口重定向”。它成本极低（几乎为零），无需额外硬件，是嵌入式开发中最基础、最核心的调试手段之一，堪称“开发者的眼睛”。

2. 手把手用STM32CubeMX配置串口

工欲善其事，必先利其器。在开始“重定向”魔法之前，我们得先把通信的管道——串口——给搭建好。这里我强烈推荐使用STM32CubeMX这个图形化配置工具，它能极大简化初始化工作，避免我们陷入寄存器配置的细节泥潭。

第一步：创建工程与芯片选型 打开STM32CubeMX，点击“New Project”。在芯片选择器里，输入你的STM32型号，比如我手头用的是STM32F103C8T6，就搜索它然后选中。别担心选错，CubeMX支持非常多型号。

第二步：配置系统核心 在“Pinout & Configuration”标签页，我们先看“System Core”部分。

点击“RCC”（复位和时钟控制）。在右侧的“High Speed Clock (HSE)”选择“Crystal/Ceramic Resonator”。这告诉芯片，我们板子外部接了高速晶振（通常是8MHz）。
点击“SYS”。在“Debug”下拉菜单里，根据你的调试器选择，比如用ST-Link就选“Serial Wire”。这个配置很重要，否则可能无法下载或调试程序。

第三步：配置串口USART1 这才是我们的主角。在左侧功能分类中找到“Connectivity”，点击“USART1”。

在右侧的“Mode”中，将模式设置为“Asynchronous”（异步通信），这是最常用的模式。
下方会自动出现两个引脚：PA9和PA10。PA9是TX（发送引脚），PA10是RX（接收引脚）。这正好对应着很多最小系统板上的“A9”、“A10”标识。如果你的板子串口接到了其他引脚，可以在这里点击引脚图进行重映射，但新手建议先用默认的。
然后看下方的“Parameter Settings”选项卡，这里配置通信参数：
- Baud Rate（波特率）：设置为115200。这是一个在速度和稳定性之间平衡很好的常用值。你的串口调试助手也要设置成一样的波特率才能通信。
- Word Length（字长）：8 bits。一个字节就是8位。
- Parity（校验位）：None。为了简单，我们不用校验。
- Stop Bits（停止位）：1。
- 其他参数保持默认即可。

第四步：配置时钟树 点击顶部的“Clock Configuration”标签页。这里像是一张芯片的“心跳”网络图。对于初学者，一个偷懒但好用的方法是：直接在左侧输入框“HCLK”里输入你芯片的最大主频（比如STM32F103C8T6是72MHz），然后回车。CubeMX会自动帮你计算并配置好各级分频器，让系统时钟跑到这个频率。这一步确保了串口等外设的时钟源是准确的，波特率才能算对。

第五步：生成工程代码 点击右上角的“Project Manager”标签页。

给你的工程起个名字，比如UART_Printf_Demo。
选择工程保存的路径。
“Toolchain / IDE”选择你用的IDE，比如“MDK-ARM V5”（Keil）或“STM32CubeIDE”。
最关键的一步：在“Code Generator”区域，勾选“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”。这会把每个外设（

标签