STM32F103RE项目编译出现未实现函数警告的原因排查

可能的原因及解决步骤 #

1. 排查第三方printf库的芯片适配逻辑 #

• 第三方printf库常针对不同STM32型号做条件编译，比如基于STM32F103RB/STM32F103RE宏或FLASH容量判断是否编译底层IO实现。
• 检查printf库源码中的条件编译分支，确认STM32F103RE对应的宏是否正确定义，且该分支包含了_write_r等函数的实现代码。

2. 调整链接符号解析优先级 #

• GCC 12.x系列对链接符号的处理规则有更新，可能RE项目中默认的弱符号优先级高于第三方printf的实现。
• 尝试在链接选项中添加-Wl,--undefined=_write，强制链接器寻找该符号，避免被空弱符号覆盖；也可以将第三方printf库的链接参数放在所有目标文件之后，提升其符号优先级。

3. 对比CubeMX HAL配置差异 #

• 即便源码结构相似，CubeMX针对RB/RE生成的HAL配置可能存在细微差别，比如USART模块是否启用（第三方printf通常绑定串口输出）。
• 对比两个项目的stm32f1xx_hal_conf.h，确认HAL_USART_MODULE_ENABLED等相关宏已开启，且printf绑定的串口初始化逻辑一致。

4. 检查链接脚本与代码优化设置 #

• stm32-cmake模板针对不同芯片可能使用不同链接脚本，RE的脚本可能未正确包含printf库的段，或--gc-sections将未显式引用的_write_r垃圾回收。
• 若开启了-ffunction-sections -fdata-sections和-Wl,--gc-sections，可添加-Wl,--keep=*_write_r*链接选项强制保留该符号；同时对比两个项目的链接脚本，确保.text等段配置一致。

5. 手动实现缺失的底层函数（临时方案） #

• 若以上方法无效，可手动实现缺失的函数避免警告，示例代码：

  #include "stm32f1xx_hal.h"
  extern UART_HandleTypeDef huart1; // 替换为你实际使用的串口句柄
  
  __attribute__((used)) int _close(int file) { return -1; }
  __attribute__((used)) int _lseek(int file, int ptr, int dir) { return 0; }
  __attribute__((used)) int _read(int file, char *ptr, int len) { return 0; }
  __attribute__((used)) int _write(int file, char *ptr, int len) {
      HAL_UART_Transmit(&huart1, (uint8_t*)ptr, len, HAL_MAX_DELAY);
      return len;
  }
  

• 添加__attribute__((used))确保函数不被编译器优化掉。

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