如何将下层CMakeLists.txt的配置传递至另一下层CMakeLists.txt？

针对你这种通过add_subdirectory引入多个子项目的场景，现代CMake的核心最佳实践是基于「目标（Target）」管理依赖，完全不需要手动复制路径或配置。具体步骤如下：

1. 在依赖项目（dependency）中正确定义库目标 #

在libs/dependency/CMakeLists.txt里，把依赖封装成一个CMake目标，并明确对外暴露的配置：

# libs/dependency/CMakeLists.txt
cmake_minimum_required(VERSION 3.10)
project(dependency)

# 收集源文件（手动列出比GLOB更可靠，避免缓存问题）
set(DEP_SOURCES
    src/file1.cpp
    src/file2.cpp
)

# 创建静态/动态库目标（根据需求选STATIC/SHARED）
add_library(dependency STATIC ${DEP_SOURCES})

# 设置头文件目录：用PUBLIC/PRIVATE区分对外暴露和内部使用的路径
target_include_directories(dependency
  PUBLIC
    ${CMAKE_CURRENT_SOURCE_DIR}/include  # 这个目录会自动传递给依赖它的项目
  PRIVATE
    ${CMAKE_CURRENT_SOURCE_DIR}/other_include  # 仅dependency内部使用，不对外暴露
    ${CMAKE_CURRENT_SOURCE_DIR}/src  # 内部源文件的头文件，无需对外
)

# 绑定C++标准等编译特性，同样用PUBLIC传递给依赖项
target_compile_features(dependency PUBLIC cxx_std_17)

# 如果dependency本身依赖其他库，用target_link_libraries绑定
target_link_libraries(dependency PRIVATE pthread)

关键说明：

• PUBLIC：表示该配置（头文件、编译选项等）既给当前目标用，也会传递给所有依赖它的目标。
• PRIVATE：仅当前目标内部使用，不会传递给依赖项，避免污染其他项目的配置。

2. 在主项目（project）中直接链接依赖目标 #

在project/CMakeLists.txt里，只需要创建自己的目标，然后直接链接dependency的目标即可，CMake会自动继承所有必要的配置：

# project/CMakeLists.txt
cmake_minimum_required(VERSION 3.10)
project(my_project)

# 收集主项目源文件
set(PROJECT_SOURCES
    src/main.cpp
    src/utils.cpp
)

# 创建可执行文件目标
add_executable(my_project ${PROJECT_SOURCES})

# 直接链接dependency目标，自动获取所有依赖配置
target_link_libraries(my_project PRIVATE dependency)

这样做的好处：

• 无需手动复制dependency的头文件路径、编译选项或链接库，所有配置通过目标自动传递。
• 后续dependency的配置变更（比如新增头文件目录、修改编译标准）会自动同步到主项目，无需手动更新。
• 避免全局变量污染，所有配置都绑定到具体目标，结构清晰可控。

复杂项目进阶技巧 #

• 如果dependency需要被外部项目复用（不仅仅是当前仓库内的project），可以通过install和export命令生成CMake配置包，让外部项目能通过find_package(dependency)导入。
• 尽量避免使用全局变量（比如set(DEP_INCLUDE_DIR ...)）传递配置，全局变量容易在复杂项目中引发冲突，目标导向是现代CMake的标准做法。

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