CMake OBJECT库与可执行文件依赖同库时的重复定义问题解决

核心CMake配置方案 #

# 初始化Pico SDK（请确保已引入pico_sdk_import.cmake）
include(pico_sdk_import.cmake)
pico_sdk_init()

add_executable(my_project
  main.c
)

add_library(lib OBJECT
  lib.c
)

# 传递基础库的头文件路径给OBJECT库及依赖它的可执行文件
target_include_directories(lib INTERFACE
  $<TARGET_PROPERTY:pico_stdlib,INTERFACE_INCLUDE_DIRECTORIES>
  $<TARGET_PROPERTY:FreeRTOS-Kernel,INTERFACE_INCLUDE_DIRECTORIES>
)

# 传递基础库的编译选项，保证OBJECT库和可执行文件编译参数一致
target_compile_options(lib INTERFACE
  $<TARGET_PROPERTY:pico_stdlib,INTERFACE_COMPILE_OPTIONS>
  $<TARGET_PROPERTY:FreeRTOS-Kernel,INTERFACE_COMPILE_OPTIONS>
)

# 仅在可执行文件层面链接所有依赖，确保基础库只被链接一次
target_link_libraries(my_project PRIVATE
  lib
  pico_stdlib
  FreeRTOS-Kernel
)

# Pico SDK必备的输出文件生成步骤
pico_add_extra_outputs(my_project)

之前配置失败的原因分析 #

1. 无PRIVATE修饰的链接
   直接使用target_link_libraries(lib pico_stdlib FreeRTOS-Kernel)时，CMake会将这些库的链接依赖传递给可执行文件，同时OBJECT库编译时会将基础库的源文件纳入编译流程，导致基础库的目标文件被重复加入链接，触发"multiple definition"错误。

2. OBJECT库用PRIVATE链接但可执行文件不补链
   PRIVATE修饰符会阻止依赖传递，可执行文件无法获取基础库的头文件路径，编译main.c时找不到FreeRTOS.h等头文件。

3. 两边都链接基础库
   基础库的源文件会被分别编译到OBJECT库和可执行文件的目标目录，链接时同一符号被多次定义，引发重复定义错误。

正确配置的关键逻辑 #

• 用INTERFACE传递编译依赖：通过INTERFACE修饰头文件路径和编译选项，既能让可执行文件获取到必要的编译信息，又不会触发链接依赖的重复传递。
• 仅在可执行文件层面链接基础库：确保pico_stdlib和FreeRTOS-Kernel这类静态库只被链接一次，从根源避免重复定义问题。
• OBJECT库专注自身编译：OBJECT库只负责编译自有源文件，链接阶段由可执行文件统一处理，其目标文件中引用的符号会由可执行文件链接的基础库解析。

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