CMake问题：仅头文件库无法被项目源文件找到，引发未定义符号

关键问题点 #

1. 根目录未配置CMake子目录引入：CMake无法识别libA目标，导致moduleA的target_link_libraries实际上没有关联到正确的库。
2. 头文件路径定位模糊：libA的target_include_directories使用相对路径，跨目录引用时CMake可能无法正确解析头文件位置。

分步修复方案 #

1. 添加根目录CMakeLists.txt #

在项目根目录Project下创建CMakeLists.txt，将两个子目录纳入构建流程：

cmake_minimum_required(VERSION 3.16)
project(YourProject)

# 引入libA模块
add_subdirectory(libs/libA)

# 引入moduleA模块
add_subdirectory(modules/moduleA)

2. 修正libA的CMake配置 #

更新libs/libA/CMakeLists.txt，明确头文件的绝对构建路径，避免跨目录解析错误：

add_library(libA INTERFACE)

# 用CMAKE_CURRENT_SOURCE_DIR指定当前目录下的include路径，确保跨目录能正确找到
target_include_directories(libA INTERFACE
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
)

3. 验证头文件包含 #

moduleA.cpp中的#include "libA.h"现在应该能正常工作，因为libA的INTERFACE包含目录已通过链接传递给moduleA。如果仍有问题，可以尝试改用#include <libA.h>（INTERFACE路径会被加入系统头文件搜索路径）。

4. 解决"未定义符号"问题 #

如果修复路径后仍出现未定义符号：

• 检查libA.h：仅头文件库要求所有函数/变量要么是inline实现，要么是模板化定义。如果是普通函数声明，需补充源文件并修改libA的CMake配置（不再是INTERFACE库）。
• 确认libA.h中没有遗漏的实现代码，确保所有声明的符号都有对应的定义。

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