STM32 使用 CMake 打印浮点数的解决方案与注意事项

在嵌入式开发中，我们经常会用 printf 来调试程序，打印整数或者字符串通常很方便，但是在 STM32 等小型 MCU 上，打印浮点数 %f 时却常常遇到问题：在某些环境下可以打印，而在另一些环境下却完全不显示小数点。

本文就结合我最近的实践经验，总结为什么会出现这个问题，以及如何在 CMake 工程中解决它。

问题现象

在家里开发环境下：

float value = 3.14;
printf("Value = %f\n", value);

可以正常打印输出：

Value = 3.140000

但是同一段代码，在公司电脑上使用相同 MCU 和工程时，却打印不出浮点数并且不显示数值

问题分析

这并不是代码逻辑的问题，而是编译器和链接器为了节省 ROM/RAM 资源对 printf 函数的浮点支持进行了优化。

默认情况下，小型 MCU 的 newlib-nano C 库 会省略浮点格式化功能，原因如下：

1. printf 浮点支持会引入大量的库函数，占用 Flash。

2. 小型 MCU 通常资源有限，编译器默认禁用浮点打印，以减少内存占用。

因此，虽然你的代码是正确的，但没有链接浮点格式化相关函数，导致 %f 无法工作。

解决方案

在 CMake 工程中，需要显式地启用浮点支持。可以在你的 CMakeLists.txt 文件的最后一行添加如下命令：

target_link_options(${CMAKE_PROJECT_NAME} PRIVATE -u _printf_float)

解释

• -u _printf_float：告诉链接器强制引用浮点支持的 printf 函数。

• target_link_options：CMake 3.13 及以上版本可以用来传递链接器选项。

• ${CMAKE_PROJECT_NAME}：你的工程 target 名称。

添加之后，重新编译并烧录 MCU，即可正常打印浮点数：

Value = 3.140000

注意事项

• Flash 占用增加
  启用浮点打印会增加约 3~5 KB 的 Flash（取决于 MCU 和库），在资源紧张的 MCU 上需要权衡。

• 调试与发布
  建议在调试阶段开启浮点打印方便验证计算结果，而在发布版本可禁用，减少 Flash 占用。

• 替代方案
  如果 Flash 非常有限，可以考虑：

  • 将浮点数乘以 1000 或 10000 转为整数打印。

  • 使用自定义简单的浮点格式化函数，仅打印固定小数位。

总结

在 STM32 等 MCU 上，浮点数打印不是 printf 的 bug，而是编译器为了节省资源的默认行为。

通过在 CMake 中添加 target_link_options(${CMAKE_PROJECT_NAME} PRIVATE -u _printf_float)，可以强制启用浮点打印功能，但需注意 Flash 占用增加。

在实际开发中，建议根据项目需求权衡调试方便性和资源占用。