如何让CMake FetchContent配合git --single-branch实现单分支克隆？

不用修改CMake模块、拆分仓库或自定义拉取逻辑，直接在FetchContent_Declare中添加GIT_CONFIG参数，覆盖远程仓库的fetch规则，就能只拉取你需要的分支。

比如要拉取分支A，代码示例如下：

FetchContent_Declare(
  your_dep_name
  GIT_REPOSITORY https://your-repo-url.git
  GIT_REF A
  GIT_SHALLOW TRUE
  GIT_CONFIG "remote.origin.fetch=+refs/heads/A:refs/remotes/origin/A"
)

这个配置会强制Git仅同步远程A分支的引用，配合GIT_SHALLOW TRUE实现浅克隆，彻底避免下载包含大文件的冗余分支数据。

原理说明 #

虽然ExternalProject_Add默认添加了--no-single-branch参数，但Git的配置优先级高于命令行参数。通过GIT_CONFIG设置remote.origin.fetch规则后，即便命令行有全局拉取的参数，Git也只会同步指定分支的内容。

全局生效的备选方案 #

如果多个依赖都需要这个规则，可以在调用FetchContent前全局覆盖克隆参数：

set(CMAKE_EXTERNALPROJECT_GIT_CLONE_FLAGS "--single-branch")

这个变量会直接替换ExternalProject_Add默认的Git克隆参数，所有后续的FetchContent或ExternalProject操作都会使用--single-branch进行克隆。

效果验证 #

使用上述任一方案后，Git只会拉取目标分支的内容，不会下载包含1GB大文件的B分支，既节省克隆时间，又大幅减少磁盘占用。

内容的提问来源于stack exchange，提问作者a-podw