ARM CM4下OpenCM3+FreeRTOS+CMake项目链接错误如何解决？

问题排查方案 #

• 路径解析问题修正
  CMake 不会自动解析~开头的用户目录路径，会导致无法正确抓取 FreeRTOS 内核源文件，生成的 FreeRTOS 静态库为空，自然找不到对应函数符号。将以下行：

set(RTOS_PATH ~/Documents/STM32/FreeRTOS-Kernel)

替换为：

set(RTOS_PATH $ENV{HOME}/Documents/STM32/FreeRTOS-Kernel)

• 链接顺序调整
  GCC 链接器按照从左到右的顺序处理依赖项，被依赖的库需要放在依赖它的对象后面，同时可以把依赖库放到--start-group段中避免循环依赖问题：

1. 修改链接库顺序：

target_link_libraries(${CMAKE_PROJECT_NAME} FreeRTOS ${OPENCM3_MCU_LIB})

2. （可选）修改链接选项的分组段，确保依赖库被正确链接：

-Wl,--start-group -lc -lgcc -lnosys ${OPENCM3_MCU_LIB} FreeRTOS -Wl,--end-group

• 验证源文件抓取结果
  在add_library(FreeRTOS STATIC ...)前加入日志输出，确认源文件抓取正常：

message(STATUS "抓取到的FreeRTOS源文件：${FreeRTOS_src}")

重新执行cmake时如果输出中包含tasks.c、queue.c、list.c等核心文件，说明路径配置正确，否则需要检查FreeRTOS内核目录结构是否符合预期。

• 配置文件校验
  确认FreeRTOSConfig.h已经放在src目录下，且没有手动禁用xTaskCreate、vTaskDelay等API的宏定义（你使用的配置默认开启这些API，无需额外修改）。
• 缓存清理
  修改完CMake配置后，删除build目录下的所有缓存文件，重新执行cmake .. && make编译即可。

内容的提问来源于stack exchange，提问作者José de França