STM32CubeIDE中Nucleo-F401RE实现printf是否有更简便方法？

我使用Nucleo-F401RE开发板，其UART2已连接ST-Link。原本以为通过USB与电脑连接后，printf打印代码可直接正常工作，但在STM32环境中并非如此。目前我需添加以下代码才能实现打印：

/* USER CODE BEGIN 4 */

int __io_putchar(int ch)
{
 uint8_t c[1];
 c[0] = ch & 0x00FF;
 HAL_UART_Transmit(&huart2, &*c, 1, 10);
 return ch;
}

int _write(int file,char *ptr, int len)
{
 int DataIdx;
 for(DataIdx= 0; DataIdx< len; DataIdx++)
 {
 __io_putchar(*ptr++);
 }
return len;
}

/* USER CODE END 4 */

我的测试代码如下：

int main(void) {

    /* USER CODE BEGIN 1 */

    /* USER CODE END 1 */

    /* MCU Configuration--------------------------------------------------------*/

    /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
    HAL_Init();

    /* USER CODE BEGIN Init */

    /* USER CODE END Init */

    /* Configure the system clock */
    SystemClock_Config();

    /* USER CODE BEGIN SysInit */

    /* USER CODE END SysInit */

    /* Initialize all configured peripherals */
    MX_GPIO_Init();
    MX_USART2_UART_Init();
    /* USER CODE BEGIN 2 */

    /* USER CODE END 2 */

    /* Infinite loop */
    /* USER CODE BEGIN WHILE */
    while (1) {
        /* USER CODE END WHILE */

        /* USER CODE BEGIN 3 */
        printf("Merhaba Fixaj STM32!\r\n");
        HAL_Delay(1000);
    }
    /* USER CODE END 3 */
}

当前代码已正常运行：

UART2配置如下：

static void MX_USART2_UART_Init(void) {

    /* USER CODE BEGIN USART2_Init 0 */

    /* USER CODE END USART2_Init 0 */

    /* USER CODE BEGIN USART2_Init 1 */

    /* USER CODE END USART2_Init 1 */
    huart2.Instance = USART2;
    huart2.Init.BaudRate = 115200;
    huart2.Init.WordLength = UART_WORDLENGTH_8B;
    huart2.Init.StopBits = UART_STOPBITS_1;
    huart2.Init.Parity = UART_PARITY_NONE;
    huart2.Init.Mode = UART_MODE_TX_RX;
    huart2.Init.HwFlowCtl = UART_HWCONTROL_NONE;
    huart2.Init.OverSampling = UART_OVERSAMPLING_16;
    if (HAL_UART_Init(&huart2) != HAL_OK) {
        Error_Handler();
    }
    /* USER CODE BEGIN USART2_Init 2 */

    /* USER CODE END USART2_Init 2 */

}

更简便的实现方式 #

1. 使用MicroLib简化重定向代码 #

如果你的开发环境（STM32CubeIDE/Keil等）支持MicroLib，这是最轻量化的方案：

• 开启MicroLib：在项目设置中启用MicroLib（STM32CubeIDE可在Project Properties > C/C++ Build > Settings > Tool Settings > MCU Settings里勾选Use MicroLib）
• 仅需实现__io_putchar函数，无需_write——MicroLib的printf会直接调用该函数：

int __io_putchar(int ch)
{
    HAL_UART_Transmit(&huart2, (uint8_t*)&ch, 1, HAL_MAX_DELAY);
    return ch;
}

注：HAL_MAX_DELAY可避免超时丢字符，也可根据需求调整超时时间。

2. DMA批量传输优化（高效场景） #

如果需要打印大量数据，可直接重定向_write到DMA传输，避免循环发送单个字符的开销：

int _write(int file, char *ptr, int len)
{
    HAL_UART_Transmit_DMA(&huart2, (uint8_t*)ptr, len);
    while(__HAL_UART_GET_FLAG(&huart2, UART_FLAG_TC) == RESET); // 等待传输完成
    __HAL_UART_CLEAR_FLAG(&huart2, UART_FLAG_TC);
    return len;
}

这种方式无需额外实现__io_putchar，适合高频、大内容的打印需求。

3. 半主机模式（仅调试场景） #

如果仅在调试阶段使用printf，可开启半主机模式，无需任何重定向代码：

• 在编译器中添加选项-specs=rdimon.specs，并链接rdimon库
• 调试时，printf内容会直接输出到开发环境的调试控制台（如STM32CubeIDE的Console窗口），无需通过UART转USB
• 缺点：脱离调试器后无法使用，不适合量产场景

内容的提问来源于stack exchange，提问作者mehmet