FetchContent_Declare后必须调用FetchContent_MakeAvailable才能使库可用；它触发下载、配置与构建，并暴露为CMake target，需在project()后、add_executable前调用。
FetchContent_Declare 之后必须调用 FetchContent_MakeAvailable
很多人写完 FetchContent_Declare 就以为库已经可用，结果编译时报错找不到目标——这是因为声明只是注册下载信息，真正拉取、解压、配置并导入到构建系统，得靠 FetchContent_MakeAvailable。它会触发下载（首次）、configure 和 build 步骤，并把库作为子项目暴露为 CMake target。
常见错误现象：target_link_libraries 报错说目标不存在，或 find_package 找不到包。
- 必须在
project()之后、任何add_executable或add_library之前调用FetchContent_MakeAvailable - 如果多个库共用同一 Git 仓库（比如 googletest 的
main和release-1.14.x分支），注意BINARY_DIR冲突，建议显式指定不同SOURCE_DIR和BINARY_DIR - 不推荐在
if(NOT TARGET xxx)里包裹FetchContent_MakeAvailable—— 它本身就有幂等性，重复调用无副作用
如何控制 Git 分支、Tag 或 Commit ID
FetchContent_Declare 支持多种 Git 定位方式，但默认行为容易让人误解：不写 GIT_TAG 时，CMake 会尝试用 main（或 master）分支，但某些旧版 CMake（
使用场景：你需要稳定构建，比如 CI/CD 或发布版本。
立即学习“C++免费学习笔记（深入）”；
- 固定到 release tag：
GIT_TAG v1.14.0（注意前缀v是否存在，查对应项目的 tag 名） - 锁定到 commit：
GIT_COMMIT a1b2c3d（最可靠，推荐用于生产） - 避免用
GIT_SHALLOW ON+GIT_TAG组合——浅克隆可能拿不到 tag 对应的 commit，导致 fetch 失败 - 若远程仓库启用了 Git Submodules，需额外加
GIT_SUBMODULES "submodule1;submodule2"，否则子模块不会初始化
链接 FetchContent 库时为什么 target_link_libraries 报“not found”
根本原因：FetchContent 导入的库名未必等于你直觉中的名字。比如 FetchContent_Declare(fmt ...) 后，实际生成的 target 是 fmt::fmt（CMake 导出的 interface target），而不是 fmt。
常见错误现象：target_link_libraries(myapp fmt) 报错，但 target_link_libraries(myapp fmt::fmt) 成功。
- 查清真实 target 名：打开
${CMAKE_BINARY_DIR}/_deps/<name>-subbuild/CMakeCache.txt，搜索_LIBRARY或_TARGETS；或看上游项目的CMakeLists.txt中add_library(... INTERFACE)定义 - 部分库（如 spdlog）提供别名 target：
spdlog::spdlog和spdlog::spdlog_header_only，按需选用 - 如果库没导出 target（比如纯头文件库且没写
install(EXPORT)），FetchContent_MakeAvailable只会设置xxx_SOURCE_DIR变量，此时要手动target_include_directories(myapp PRIVATE ${xxx_SOURCE_DIR}/include)
本地开发时如何跳过重复下载和构建
FetchContent 默认每次 configure 都检查更新（尤其用了 GIT_TAG 时），但开发中改自己代码时并不想重拉或重 configure 第三方库——这很慢，还可能因网络失败中断流程。
性能影响：对大型库（如 LLVM、OpenCV）尤其明显，一次 fetch+configure 可能耗时数分钟。
- 临时跳过：设环境变量
FETCHCONTENT_FULLY_DISCONNECTED=ON，CMake 将完全跳过所有 FetchContent 操作（要求已存在_deps目录） - 更稳妥的做法是用
FetchContent_GetProperties检查是否已存在：
FetchContent_GetProperties(fmt)
if(NOT fmt_POPULATED)
FetchContent_Populate(fmt)
add_subdirectory(${fmt_SOURCE_DIR} ${fmt_BINARY_DIR})
endif()
FETCHCONTENT_QUIET=ON 减少日志干扰；调试时可设 FETCHCONTENT_VERBOSE=ON 查看每步命令最容易被忽略的是：FetchContent 不处理依赖传递。比如你拉了 gtest，它依赖 gmock，但如果你没单独 declare gmock，CMake 不会自动递归解析——得自己补全，或者确认上游项目是否已通过 add_subdirectory 或 find_package 内置处理。
