STM32CubeIDE的Printf串口重定向

最近在使用STM32CUBEMX+STM32CUBEIDE调试嵌入式AI项目时，发现将之前keil中使用的printf()重定向代码移植到STM32CUEBIDE中，无法使用。代码无报错、编译无异常、工程可正常烧录运行，但串口始终无任何打印输出。

经过排查发现，该问题并非代码BUG，而是Keil MDK（ARMCC编译器）与STM32CubeIDE（GCC编译器）的底层编译机制、标准库适配、重定向接口定义存在本质差异。Keil适配的fputc重定向代码，无法直接兼容CubeIDE的GCC编译环境。

1. 添加重定向代码

摒弃Keil的fputc写法，采用GCC标准的 _write 函数重载方式，支持字符串、数字、浮点数据打印，兼容所有HAL库STM32芯片。可直接将代码添加到 main.c、usart.c 或单独的串口工具文件中。

c 复制代码

#include <stdio.h>

// 强制覆盖标准库
int __io_putchar(int ch)
{
    HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, 0xffff);
    return ch;
}

// 兼容所有库版本
int fputc(int ch, FILE *f)
{
    return __io_putchar(ch);
}

2. 开启浮点打印支持

嵌入式AI项目需要频繁打印模型权重、推理精度、传感器浮点数据，默认配置下CubeIDE不支持printf浮点输出，需手动开启：

右键工程 → Properties → C/C++ Build → Settings → Tool Settings → MCU Settings
勾选 Use float with printf from newlib-nano
保存配置，重新编译工程

在main函数的while(1)循环前添加测试代码，覆盖普通字符串、整型、浮点型数据，适配嵌入式AI调试场景：

c 复制代码

  /* USER CODE BEGIN 2 */
  // printf重定向测试
  float ai_score = 0.9658f;  // 模拟AI推理置信度
  int sensor_data = 2048;     // 模拟传感器数据

  printf("===== STM32CubeIDE Printf 调试输出 =====\r\n");
  printf("AI模型推理置信度：%.4f\r\n", ai_score);
  printf("传感器采集数据：%d\r\n", sensor_data);
  printf("串口重定向适配成功！\r\n\r\n");
  /* USER CODE END 2 */

烧录运行后，串口调试工具（波特率115200）可正常输出所有日志，包含浮点数据，无乱码、无缺失。