add_subdirectory要求子目录必须包含cmakelists.txt，且不能重复调用project()；路径相对当前文件，支持指定二进制输出目录；链接时须用target名而非路径，且需确保add_subdirectory先于target_link_libraries调用。
add_subdirectory 要求子目录必须包含 CMakeLists.txt
调用 add_subdirectory 时，CMake 会立即进入指定路径，查找并解析其中的 CMakeLists.txt。如果该文件不存在，会报错：add_subdirectory given source "xxx" which is not an existing directory or an existing CMakeLists.txt file.
常见错误是误以为只要目录存在就能加——其实它不认空目录、不认 src/ 这类普通文件夹，只认有合法 CMakeLists.txt 的模块根目录。
- 子目录的
CMakeLists.txt必须能独立执行（即不依赖父作用域未定义的变量） - 路径是相对于当前
CMakeLists.txt的，支持相对路径如add_subdirectory(src)或add_subdirectory(../third_party/openssl) - 不能使用通配符或变量拼接路径，比如
add_subdirectory(${LIB_DIR})在 CMake 3.19+ 才支持，且需确保变量已定义且为字符串字面量
子目录中不要重复调用 project()，否则会报错
一个 CMake 工程中 project() 只能出现一次（顶层调用后，所有子目录都共享该项目上下文）。如果子目录的 CMakeLists.txt 也写了 project(mylib)，CMake 会直接中断并报错：project PROJECT_NAME must be called before add_subdirectory 或类似提示（实际错误信息可能因版本略有差异）。
子目录只需定义目标：用 add_library 或 add_executable，然后通过 target_include_directories、target_link_libraries 管理依赖即可。
- 子目录可读取父级定义的变量（如
CMAKE_BUILD_TYPE），但不能修改其作用域外的缓存变量（除非显式用set(... PARENT_SCOPE)） - 若子目录需要条件逻辑（如仅在 Linux 下构建），直接用
if(CMAKE_SYSTEM_NAME STREQUAL "Linux")，无需重新 project
add_subdirectory 的第二个参数控制二进制输出位置
add_subdirectory 支持两个参数：add_subdirectory(source_dir [binary_dir])。第二个参数指定该子目录构建产物（如 .o、.a、中间 CMake 缓存）存放路径，默认与源目录同名、位于构建树下。
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
例如：项目结构为 ./CMakeLists.txt 和 ./lib/utils/CMakeLists.txt，执行 add_subdirectory(lib/utils build_utils) 后，CMake 会在构建目录下创建 build_utils/ 子目录，而不是默认的 lib/utils/。
- 该
binary_dir必须是相对路径，且不能是上级目录（如../out不合法） - 若多个
add_subdirectory指向同一binary_dir，会导致构建冲突（CMake 不允许并发写同一构建树） - 大多数情况下用单参数就够了；显式指定 binary_dir 主要用于隔离大型子模块或适配已有构建习惯
链接子目录目标时，target_link_libraries 接收的是 target 名，不是路径
子目录中定义的 add_library(myutils STATIC ...) 创建了一个名为 myutils 的 target。父目录想链接它，必须用这个名字，而不是路径或文件名：
add_subdirectory(lib/utils) add_executable(main main.cpp) target_link_libraries(main PRIVATE myutils) # ✅ 正确：用 target 名 # target_link_libraries(main PRIVATE lib/utils/libmyutils.a) ❌ 错误：CMake 不认路径
如果子目录用了 add_library(myutils INTERFACE)，它本身不生成文件，但可通过 target_include_directories 和 target_compile_definitions 透出接口属性，父目录仍用名字链接即可继承这些设置。
- 子目录 target 名在全局唯一；重名会导致 CMake 报错：
add_library cannot create target "xxx" because another target with the same name already exists - 跨子目录引用时，确保
target_link_libraries出现在add_subdirectory之后，否则 target 尚未注册，会报target "xxx" not found
子目录机制本身轻量，但容易在路径、命名和作用域上卡住——最常被忽略的是子目录里多写了 project()，或者误把库路径当 target 名传给 target_link_libraries。
