使用CMake的add_subdirectory链接上游INTERFACE目标时出错如何解决？

错误原因 #

你遇到的错误本质是：你在target_link_libraries中引用的目标（错误信息里的matplotlib_cpp，对应你代码里的main_target）根本没在当前CMake项目中被创建。根目录的CMakeLists.txt里只通过set(TARGET_NAME main_target)定义了变量，但没有用add_executable或add_library指令生成这个目标，CMake找不到它，所以抛出错误。

修复步骤 #

修改根目录的CMakeLists.txt，先创建目标，再执行链接操作：

修改后的根目录CMakeLists.txt #

project(main_project)
set(TARGET_NAME main_target)

# 先创建目标：这里假设是可执行文件，你需要根据实际情况调整
# 如果是库，换成 add_library(${TARGET_NAME} ...)
add_executable(${TARGET_NAME} main.cpp)

add_subdirectory(foo)
target_link_libraries(${TARGET_NAME}
  PRIVATE  # 注意：可执行文件一般用PRIVATE而非INTERFACE，INTERFACE是给库目标传递依赖用的
    foo::foo
)

额外注意点 #

• 如果你实际项目中的目标是matplotlib_cpp，要确保先通过add_executable(matplotlib_cpp ...)或add_library(matplotlib_cpp ...)创建这个目标，再执行target_link_libraries。
• 链接关键字选择：INTERFACE用于库目标，给依赖它的下游目标传递编译选项、头文件路径；可执行文件作为最终产物，一般用PRIVATE即可。

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