嵌套子目录下CMake链接可执行文件失败的技术求助

问题根源 #

链接错误cannot find -lstdModB/2的核心原因：

• 你在target_link_libraries中传入的是模块路径stdModB/2，CMake将其视为库名传递给链接器，生成-lstdModB/2参数，但实际该子目录构建出的库目标名是2，库文件为lib2.a，两者不匹配。

解决方案 #

方案1：显式维护模块路径与目标名的对应关系 #

修改app1/CMakeLists.txt，不再直接用路径字符串作为链接目标，而是跟踪每个模块的实际库目标名：

cmake_minimum_required(VERSION 3.25)
project(app1 LANGUAGES C CXX)

list(APPEND APP_SRCS "main.c")

# 定义模块列表：格式为"模块路径;库目标名"
set(MODULES
  "stdModA;stdModA"
  "stdModB/2;2"
)

set(MOD_TARGETS "")
foreach(MOD IN LISTS MODULES)
  # 拆分模块路径和目标名
  string(REPLACE ";" " " MOD_PAIR ${MOD})
  list(GET MOD_PAIR 0 MOD_PATH)
  list(GET MOD_PAIR 1 MOD_TARGET)
  
  add_subdirectory(../${MOD_PATH} MYBUILD/${MOD_PATH})
  list(APPEND MOD_TARGETS ${MOD_TARGET})
endforeach()

add_executable(${PROJECT_NAME}.elf ${APP_SRCS})

# 添加头文件路径
foreach(MOD IN LISTS MODULES)
  list(GET MOD 0 MOD_PATH)
  target_include_directories(${PROJECT_NAME}.elf PUBLIC ../${MOD_PATH})
endforeach()

# 使用实际库目标名链接
target_link_libraries(${PROJECT_NAME}.elf PUBLIC ${MOD_TARGETS})

方案2：子目录导出目标名到父目录 #

在每个模块的CMakeLists.txt中导出目标名，让父目录直接引用：

1. 修改stdModA/CMakeLists.txt，添加导出语句：

cmake_minimum_required(VERSION 3.25)
set(MOD_NAME "stdModA")
add_library(${MOD_NAME} STATIC stdModA.c)
target_include_directories(${MOD_NAME} PUBLIC ../app1)

# 将目标名导出到父目录
set(STD_MOD_A_TARGET ${MOD_NAME} PARENT_SCOPE)

2. 修改stdModB/2/CMakeLists.txt，添加导出语句：

cmake_minimum_required(VERSION 3.25)
set(MOD_NAME "2")
add_library(${MOD_NAME} STATIC stdModB.c)
target_include_directories(${MOD_NAME} PUBLIC ../.. )

# 将目标名导出到父目录
set(STD_MOD_B_2_TARGET ${MOD_NAME} PARENT_SCOPE)

3. 修改app1/CMakeLists.txt的链接部分：

cmake_minimum_required(VERSION 3.25)
project(app1 LANGUAGES C CXX)

list(APPEND APP_SRCS "main.c")

list(APPEND MODS "stdModA")
list(APPEND MODS "stdModB/2")

foreach(MOD IN LISTS MODS)
  add_subdirectory(../${MOD} MYBUILD/${MOD})  
endforeach()

add_executable(${PROJECT_NAME}.elf ${APP_SRCS})

foreach(MOD IN LISTS MODS)
  target_include_directories(${PROJECT_NAME}.elf PUBLIC ../${MOD})
endforeach()

# 使用子目录导出的目标名链接
target_link_libraries(${PROJECT_NAME}.elf PUBLIC ${STD_MOD_A_TARGET} ${STD_MOD_B_2_TARGET})

原理说明 #

CMake中，target_link_libraries接受两种参数：

• 已通过add_library定义的目标名：CMake会自动处理该目标的路径、依赖等，无需手动指定库文件位置。
• 字符串形式的库名：CMake会将其转换为-l<库名>参数传递给链接器，此时链接器会在系统默认路径中寻找对应库文件，无法识别带路径的字符串。

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