GCC项目中通过独立.c文件覆写(s)printf函数的实现方法

替换方案底层工作原理 #

这套替换逻辑完全依托GCC工具链的默认链接规则实现，没有特殊黑魔法：

• 链接器解析符号时，项目自身编译生成的目标文件里的全局强符号，优先级永远高于标准C库（arm-none-eabi-gcc自带的newlib/newlib-nano）里的同名库符号。只要自有代码实现了和标准库函数签名一致的printf、sprintf全局函数，链接器就会优先链接自有版本，不会把标准库中的对应实现拉入最终elf产物。
• FreeRTOS附带的printf-stdarg.c本身是完全自包含的实现：文件内部写全了可变参数读取、格式化字符串解析、不同数据类型转换的全部逻辑，对外导出和标准库同名的printf、sprintf函数，不依赖其他外部代码，也不需要额外的初始化注册流程。

检测不到对应符号的原因 #

你执行arm-none-eabi-readelf -s my_program.elf | grep 'stdarg'查不到结果是正常现象，完全不能说明替换失败：

printf-stdarg.c只是文件名带stdarg字样，它对外导出的函数是printf、sprintf，整个文件内根本不存在名称带"stdarg"的函数或全局符号，用stdarg作为关键词搜索符号表自然得不到任何结果。

正确的替换验证方式是执行如下命令：
arm-none-eabi-nm my_program.elf | grep -w -E 'printf|sprintf'
查看输出符号对应的地址，如果落在项目代码的Flash运行地址区间，就说明替换成功。另外如果你开启了-ffunction-sections -fdata-sections加-Wl,--gc-sections的体积优化选项，只要项目代码全程没有调用过printf/sprintf，链接器会直接把这部分未使用的函数裁掉，也会查不到对应符号，属于正常表现。

正确配置要求 #

不需要添加特殊链接参数，不需要在main.c中增加专门的初始化代码，也不需要刻意调整源文件在编译列表中的顺序，只要满足以下要求即可正常完成替换：

• 确认printf-stdarg.c被正常加入项目的源码编译列表，和项目内其他业务.c文件走完全相同的编译流程，能生成对应的.o目标文件，不要把文件放在编译排除目录下。
• 源文件顺序不影响替换结果：所有项目自身的目标文件都会在标准库之前参与符号解析，不管printf-stdarg.c在CSRCS列表中排前面还是末尾，它导出的printf/sprintf符号优先级都高于标准库实现。
• 如果使用arm-none-eabi-gcc默认的newlib-nano库，不管是否添加-specs=nosys.specs、-u _printf_float这类常规编译参数，都不会影响替换逻辑。
• 注意官方标注的使用限制：这个精简实现没有提供完整的snprintf()功能，如果代码中调用了snprintf，链接器还是会拉取标准库的对应实现，不会被该文件替换。
• 如果需要让printf输出到MCU串口，只需要打开printf-stdarg.c，找到文件内负责单字符输出的底层桩函数（不同Demo里的版本命名略有区别，一般叫outbyte或者自定义的putchar实现），把函数内的逻辑改成往所用串口的发送寄存器写字符即可，唯一要求是自有串口初始化代码要在第一次调用printf之前执行完，不需要额外的注册操作。

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