https://blog.csgo.ovh/categories/stm32/Recent content in STM32 on Crazy blogHugozh-HansMon, 28 Sep 2026 23:11:22 +0800https://blog.csgo.ovh/posts/123-stm32-printf-to-uart-quick-guide/Mon, 28 Sep 2026 23:11:22 +0800https://blog.csgo.ovh/posts/123-stm32-printf-to-uart-quick-guide/<p>在嵌入式开发与调试过程中，<code>printf</code> 是最直观、最常用的日志输出工具。许多新手在刚接触 STM32 时，往往被繁琐的标准库/底层系统调用重写搞得一头雾水。</p> <p>本文介绍一种<strong>极简、直接且跨平台兼容</strong>的 <code>printf</code> 重定向方法，涵盖 <strong>Keil MDK</strong> 与 <strong>STM32CubeIDE (GCC)</strong> 两大主流开发环境，3 分钟即可配置完毕。</p> <hr> <h2 id="核心原理" class="relative group">核心原理 <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#%e6%a0%b8%e5%bf%83%e5%8e%9f%e7%90%86" aria-label="锚点">#</a></span></h2><p>C 语言标准库中的 <code>printf</code> 底层最终通过字符输出函数将字符逐个写入底层硬件：</p> <ul> <li><strong>Keil MDK (ARM Compiler)</strong>：依赖标准 I/O 的 <code>fputc(int ch, FILE *f)</code>。</li> <li><strong>GCC / STM32CubeIDE</strong>：底层通常走 <code>__io_putchar(int ch)</code> 或 <code>_write()</code> 系统调用。</li> </ul> <p>我们只需要重写对应的底层单字符发送函数，将其映射到 STM32 的串口发送函数（如 <code>HAL_UART_Transmit</code>）即可。</p> <hr> <h2 id="一代码实现以-hal-库为例" class="relative group">一、代码实现（以 HAL 库为例） <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style="text-decoration-line: none !important;" href="#%e4%b8%80%e4%bb%a3%e7%a0%81%e5%ae%9e%e7%8e%b0%e4%bb%a5-hal-%e5%ba%93%e4%b8%ba%e4%be%8b" aria-label="锚点">#</a></span></h2><p>打开工程的 <code>main.c</code>（或单独的 <code>retarget.c</code> 文件），完成以下两步：</p>