一、引言

很多STM32新手在调试时，习惯在中断服务函数（ISR）里直接调用printf打印日志，以为只是“输出一句信息”，结果却发现系统越来越卡、丢中断、抖动甚至HardFault。这篇文章就来拆解：为什么中断里不能随便用printf，以及该怎么替代它。

二、printf到底慢在哪？

你以为printf只是一条输出指令，实际上它内部做了三件事，每一件都可能拖慢中断：

1. 格式化字符串：printf内部会调用sprintf，把整数、浮点数转换成字符串，这个过程本身就需要时间。
2. 库函数锁：标准C库的printf是不可重入的，会访问全局缓冲区，可能进入临界区，导致其他任务被阻塞。
3. 串口发送：默认的printf重定向到串口，会等待TXE（发送寄存器空）或DMA资源，这个等待过程在中断里会变成“阻塞”。

这三步加起来，ISR的执行时间会从几微秒变成几毫秒，直接打破中断“快进快出”的原则。

三、为什么中断里不能用printf？

中断的核心要求是实时性，必须“快进快出”，如果在中断里做了耗时操作，会引发三个问题：

1. 实时性崩溃：printf阻塞了中断，导致后续任务无法及时响应，出现丢中断、抖动、延迟飙升。
2. 重入风险：如果主循环和中断里同时调用printf，会访问同一个底层库，导致死锁、缓冲区乱、甚至HardFault。
3. 调试变灾难：你本来是想打印日志排查问题，结果printf本身成了问题的根源，越调越乱。

四、正确做法：中断只做短动作

正确的原则是：中断负责通知，任务负责处理。具体来说：

1. ISR里只做三件事：置标志位、存少量数据、清中断标志。
2. 主循环/任务里处理打印：把数据从缓冲区取出来，统一格式化、发送。

代码示例：标志位+主循环处理

#include "stm32f1xx_hal.h"
#include <stdio.h>

// 定义标志位和数据缓冲区
volatile uint8_t isr_flag = 0;
volatile uint32_t isr_data = 0;

// 串口初始化（省略，假设已完成）
UART_HandleTypeDef huart1;

// 中断服务函数：只置标志位和存数据
void EXTI0_IRQHandler(void)
{
  HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_0);
  isr_data = HAL_GetTick(); // 存当前tick
  isr_flag = 1; // 置标志位
}

// 主循环：处理打印
int main(void)
{
  HAL_Init();
  SystemClock_Config();
  MX_GPIO_Init();
  MX_USART1_UART_Init();

  while (1)
  {
    if (isr_flag)
    {
      printf("ISR triggered at tick: %lu\r\n", isr_data);
      isr_flag = 0; // 清标志位
    }
    // 其他任务...
  }
}

进阶：环形缓冲区+DMA发送

如果中断频率很高，标志位不够用，可以用环形缓冲区（Ring Buffer）来暂存数据，主循环里统一发送：

#include "stm32f1xx_hal.h"
#include <stdio.h>
#include <string.h>

#define RING_BUFFER_SIZE 64
uint8_t ring_buffer[RING_BUFFER_SIZE];
volatile uint16_t ring_head = 0;
volatile uint16_t ring_tail = 0;

UART_HandleTypeDef huart1;

// 环形缓冲区写函数
void ring_buffer_write(uint8_t data)
{
  uint16_t next = (ring_head + 1) % RING_BUFFER_SIZE;
  if (next != ring_tail)
  {
    ring_buffer[ring_head] = data;
    ring_head = next;
  }
}

// 环形缓冲区读函数
uint8_t ring_buffer_read(void)
{
  uint8_t data = 0;
  if (ring_head != ring_tail)
  {
    data = ring_buffer[ring_tail];
    ring_tail = (ring_tail + 1) % RING_BUFFER_SIZE;
  }
  return data;
}

// 中断服务函数：只写数据到环形缓冲区
void EXTI0_IRQHandler(void)
{
  HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_0);
  uint8_t data = (uint8_t)(HAL_GetTick() & 0xFF); // 取低8位作为示例
  ring_buffer_write(data);
}

// 主循环：从环形缓冲区读数据并打印
int main(void)
{
  HAL_Init();
  SystemClock_Config();
  MX_GPIO_Init();
  MX_USART1_UART_Init();

  while (1)
  {
    if (ring_head != ring_tail)
    {
      uint8_t data = ring_buffer_read();
      printf("Received data: 0x%02X\r\n", data);
    }
    // 其他任务...
  }
}

五、总结：中断里别做慢操作

最后给大家整理了一张判断表，记住：先保实时性，再谈调试方便。

六、参考资料

• STM32中断服务函数中调用printf导致系统卡死
• STM32 UART Transmit Tutorial using LL Drivers
• STM32 HAL库串口IDLE中断接收与环形缓冲区实战

如果你觉得这篇文章对你有帮助，欢迎点赞、收藏、转发，也可以关注我，一起学习STM32开发的避坑技巧！