在STM32开发中，使用printf函数通过串口输出调试信息是一种高效的调试手段。然而，不正确的配置常常会导致程序运行异常，例如程序崩溃、串口输出乱码等。本文将系统性地分析这些问题的根本原因，并提供相应的解决方案。

基础：正确的 printf 重定向方法

要使 printf 通过UART正常工作，首先需要重定向C标准库的fputc函数，使其将字符数据流导向UART发送接口。

#include "stdio.h"

// 假设使用USART1，其HAL库句柄为huart1
extern UART_HandleTypeDef huart1;

/**
  * @brief  重定向 fputc 函数以适配 printf 输出到 UART
  * @param  ch: 要发送的字符
  * @param  f: 文件指针 (未使用)
  * @retval ch: 返回发送的字符
  */
int fputc(int ch, FILE *f)
{
  // 调用HAL库函数，通过UART1发送一个字节
  // 最后一个参数是超时时间，设为0xFFFF表示阻塞式发送
  HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, 0xFFFF);
  return ch;
}

完成以上配置后，理论上 printf 就可以工作了。但在实际应用中，常常会遇到以下几类问题。

问题一：串口输出乱码 (Garbled Output)

这是最常见的问题，通常表现为两种形式。

情况一：输出不规则的符号

• 原因： 波特率不匹配。

• 分析： MCU端UART外设的波特率与PC端串口终端工具设置的波特率必须完全一致。任何偏差都会导致数据帧的位采样点错误，从而解码出错误的数据。

• 解决方案： 检查并统一波特率。 确保在STM32CubeMX中为UART配置的 huart.Init.BaudRate 值，与您在串口终端软件（如PuTTY, Tera Term）中设置的波特率完全相同。

情况二：输出大量的问号 ? 或固定乱码

• 原因： 系统时钟配置错误或时钟源不稳定。

• 分析： UART外设的波特率发生器依赖于其总线时钟（APB1或APB2时钟）。如果系统时钟树配置不正确，会导致供给UART的时钟频率与预期不符，即使代码中设置了正确的波特率数值，实际生成的信号频率也是错误的。

  1. 时钟树配置错误： 例如，PLL（锁相环）的输入源、分频/倍频系数计算错误，导致系统主频（SYSCLK）或APB总线时钟不正确。

  2. 外部晶振(HSE)硬件问题： 外部晶振本身或其负载电容不匹配，可能导致晶振未起振或频率不稳定。

• 解决方案：

  1. 检查CubeMX时钟配置： 仔细审查时钟树，确保从时钟源（HSE/HSI）到SYSCLK，再到APB1/APB2总线的各级分频系数都正确无误。

  2. 隔离硬件问题： 作为诊断手段，可以尝试将时钟源从外部高速时钟（HSE）切换到内部高速时钟（HSI）。如果乱码问题消失，则基本可以确定问题出在外部晶振的硬件电路上。

问题二：程序在调用printf后崩溃 (Program Crash)

现象为：不使用printf时程序正常运行，一旦加入printf调用，程序就无响应或进入HardFault。

• 原因： 堆栈溢出 (Stack Overflow)。

• 分析： printf函数（尤其是处理格式化字符串和多种数据类型时）内部实现复杂，执行时需要在栈（Stack）上分配相当大的内存空间。如果为程序分配的栈空间不足，调用printf就会导致栈溢出，破坏函数调用栈帧，最终引发HardFault。

• 解决方案： 增大栈和堆的预留空间。

  1. 在Keil MDK或STM32CubeIDE中，找到项目的启动文件（通常是 .s 汇编文件，如 startup_stm32f407xx.s）。

  2. 在文件头部找到 Stack_Size 和 Heap_Size 的定义。

  3. 将其默认值（如 0x400 和 0x200）增大。对于需要频繁使用printf的项目，建议将 Stack_Size 至少设置为 0x1000 (4KB)，Heap_Size 设置为 0x400 (1KB) 或更大。

  codeAssembly

  downloadcontent_copy

  expand_less

  Stack_Size      EQU     0x00001000 ; 增大栈空间
  Heap_Size       EQU     0x00000400 ; 增大堆空间