cmake学习--add_subdirectory
add_subdirectory引入的是构建规则，不是目标文件
当你执行add_subdirectory时，CMake 会：
读取子目录中的
CMakeLists.txt解析其中的构建指令（如
add_library,add_executable）记录这些目标和依赖关系到 CMake 的构建数据库中
此时并没有编译任何文件，也没有生成目标文件（.o/.obj）或可执行文件。
完整流程示例
# 顶层 CMakeLists.txt cmake_minimum_required(VERSION 3.10) project(Demo) add_subdirectory(lib) # ① 只是注册构建规则 add_executable(main main.cpp) target_link_libraries(main mylib) # ② 建立依赖关系
下级的lib的cmakelist：
# lib/CMakeLists.txt add_library(mylib util.cpp) # ③ 注册库的构建规则
各阶段发生的事情：
| 阶段 | 命令 | 实际行为 |
|---|---|---|
| 配置阶段(cmake ..) | add_subdirectory(lib) | 读取lib/CMakeLists.txt，记录"需要构建mylib这个库" |
| 配置阶段 | target_link_libraries(main mylib) | 记录"main需要链接mylib" |
| 生成阶段(cmake ..) | - | 生成 Makefile/Ninja 文件，包含完整构建规则 |
| 构建阶段(make) | make main | 才真正编译，util.cpp生成util.o，然后链接成libmylib.a，最终由main链接libmylib.a |
关键理解
# 配置阶段：只读 CMakeLists.txt，不编译 $ cmake .. -- Configuring done # add_subdirectory 在这里生效 -- Generating done # 此时查看 build 目录，还没有 .o 或 .a 文件 $ ls lib/ CMakeFiles/ CMakeLists.txt # 只有 CMake 的缓存文件
$ make Scanning dependencies of target mylib [ 25%] Building CXX object lib/CMakeFiles/mylib.dir/util.cpp.o [ 50%] Linking CXX static library libmylib.a # ← 中间产物：静态库mylib Scanning dependencies of target main [ 75%] Building CXX object CMakeFiles/main.dir/main.cpp.o [100%] Linking CXX executable main
引入的具体内容
add_subdirectory引入的是CMake 目标（Target）的定义：
cmake
add_subdirectory(lib) # 之后，你可以使用子目录中定义的目标名称 target_link_libraries(main mylib) # mylib 是"目标名称" target_include_directories(main PRIVATE lib) # 甚至可以使用目录路径
这些目标包含：
源文件列表（如
util.cpp）编译选项（
target_compile_options）链接库依赖
包含路径（
target_include_directories）自定义命令等
类比理解
可以把add_subdirectory理解为：
不是“把做好的饭菜端过来”
而是“把菜谱加入菜单”，告诉厨师（编译器）如何做这道菜
实际烹饪（编译）发生在
make或cmake --build时
与预编译库的对比
# 方式1：add_subdirectory（有源码） add_subdirectory(lib) # 引入构建规则 # 构建时才会编译 util.cpp -> libmylib.a # 方式2：使用预编译库（已有 libmylib.a） add_library(mylib STATIC IMPORTED) # 直接引入已存在的二进制文件 set_target_properties(mylib PROPERTIES IMPORTED_LOCATION /path/to/libmylib.a) # 不需要编译，直接使用
总结
add_subdirectory引入的是构建规则/目标定义（逻辑实体）目标文件（
.o,.a,.exe）是在后续make/cmake --build构建阶段才生成的好处：配置阶段快速，可以根据条件决定是否引入子目录，依赖关系清晰
这就是为什么 CMake 分两个阶段（配置+生成 vs 构建）—— 先用add_subdirectory组织构建逻辑，再实际编译产生二进制文件。
配置阶段：记录"需要构建
libmylib.a和main"构建阶段：
先编译
util.cpp→util.o归档
util.o→libmylib.a（中间产物）编译
main.cpp→main.o链接
main.o + libmylib.a→main（最终可执行文件）