因为add_subdirectory只接受本地路径，无法直接处理Git URL；CMake需先通过FetchContent或ExternalProject下载远程仓库到本地，再用add_subdirectory加载其CMakeLists.txt。
为什么不能直接用 add_subdirectory 加载远程 Git 仓库
CMake 本身不支持在 add_subdirectory 中直接写 Git URL（比如 add_subdirectory("https://github.com/abc/lib.git")），会报错 source directory does not exist。CMake 只处理本地路径，Git 下载必须提前完成或由构建系统触发。
用 FetchContent 实现编译时自动拉取
FetchContent 是 CMake 3.11+ 内置模块，专为“按需下载 + 解压 + 构建”设计，比手写 execute_process 更可靠，且能缓存、支持 tag/commit 指定。
常见错误是忽略声明顺序：必须在 project() 之后、add_subdirectory() 或 add_library() 之前调用 FetchContent_Declare 和 FetchContent_MakeAvailable。
- 指定 commit 或 tag 更稳定：
GIT_TAG v1.2.3或GIT_COMMIT abc1234，避免主分支变动导致构建失败 - 若依赖项含自己的
CMakeLists.txt，FetchContent_MakeAvailable会自动执行其add_library等逻辑 - 首次构建会下载并解压到
${CMAKE_BINARY_DIR}/_deps/，后续复用缓存——但切换GIT_TAG后不会自动清理旧版本，需手动删_deps/<name>-src
include(FetchContent) FetchContent_Declare( fmt GIT_REPOSITORY https://github.com/fmtlib/fmt.git GIT_TAG 10.2.1 ) FetchContent_MakeAvailable(fmt) <h1>此后可直接 link：target_link_libraries(myapp PRIVATE fmt::fmt)
遇到 Failed to run 'git' command 怎么办
不是权限问题，而是 CMake 找不到 git 命令。它依赖环境 PATH，而非系统默认安装位置。
立即学习“C++免费学习笔记（深入）”；
使用约定式提交（Conventional Commits）从 Git 历史记录中生成结构化变更日志，支持多种格式、AI 增强型描述以及可自定义的范围……
- Windows 上常见于 MSVC 开发者命令行未激活 Git，或 Git 安装时没勾选 “Add Git to PATH”
- CI 环境（如 GitHub Actions）需显式安装 Git：Ubuntu 用
apt-get install git，Windows 用msys2或choco install git - 可用
find_package(Git REQUIRED)提前检测，并用${GIT_EXECUTABLE}验证路径
替代方案：ExternalProject_Add 的适用边界
当依赖项没有 CMake 支持（比如纯 Makefile 项目），或需要自定义构建步骤（如 configure + make）、安装到指定 prefix 时，ExternalProject_Add 更灵活，但它不提供 target 导出，需手动 add_library(... IMPORTED) 并设置 IMPORTED_LOCATION。
容易踩的坑：它默认在构建阶段才执行下载和编译，无法像 FetchContent 那样让 CMake 在 configure 阶段就解析依赖结构；且每次 clean 构建都会重跑整个 ExternalProject 流程，速度慢。
真正要跨语言、跨构建系统集成时才考虑它，日常 C++ 第三方库优先用 FetchContent。
Git 仓库地址拼写错误、网络超时、SSH vs HTTPS 权限混用，这些都比 CMake 语法更容易中断构建流程。调试时先确保能在终端里手动 git clone 成功，再让 CMake 接管。
