CMake动态共享库集成至外部项目时无法找到自身include目录问题

错误根因 #

• 相对路径../include失效：target_include_directories传入的相对路径，是相对于CMake执行时的工作目录，而非当前CMakeLists.txt的存储目录。当mylib作为子模块集成到主项目时，工作目录切换为主项目根目录，../include会指向主项目根目录的上级目录，无法匹配到mylib自身的头文件目录。
• ${CMAKE_SOURCE_DIR}指向错误：该变量始终指向整个工程最顶层CMakeLists.txt所在的目录，也就是主项目的根目录，拼接后路径为主项目根目录/include，并非mylib目录下的include文件夹，因此也无法找到头文件。

最优修复方案（无需主项目额外配置） #

直接修改mylib内部的/src/CMakeLists.txt，使用CMAKE_CURRENT_SOURCE_DIR变量（该变量永远指向当前正在处理的CMakeLists.txt所在的目录，也就是mylib/src目录），配合构建接口表达式保证复用性：

add_library(mylib SHARED
    camera/Camera.cpp
)
target_include_directories(mylib PUBLIC 
    # 构建阶段用的头文件路径，适配独立编译和作为子模块编译的场景
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/../include>
    # 安装阶段用的头文件路径，适配库安装后引用的场景
    $<INSTALL_INTERFACE:include>
)

修改后无论独立编译mylib，还是将mylib作为子目录集成到其他项目，都可以自动正确识别头文件路径，不需要主项目额外配置头文件搜索路径。

现有修复方案说明 #

你通过在主项目手动添加mylib头文件路径的方式可以解决问题，但不符合CMake组件复用的规范，每次集成mylib到新项目都需要手动加路径，维护成本更高，更推荐修改mylib内部的CMake配置。

内容的提问来源于stack exchange，提问作者Mateusz Wójt