FetchContent是CMake 3.14引入的模块，用于在构建时自动下载并集成第三方库。通过FetchContent_Declare声明依赖源（如Git仓库或ZIP包），再调用FetchContent_MakeAvailable触发下载与配置，使外部库成为项目的一部分，支持直接链接目标。相比ExternalProject_Add更简单直观，适合现代CMake工作流，推荐结合find_package优先查找系统库，未找到时回退到网络获取，提升构建效率与可移植性。
在现代C++项目中，依赖管理是一个关键环节。使用CMake的FetchContent模块可以让你在构建时自动下载并集成第三方库，无需手动管理子模块或外部构建流程。这种方式特别适合开源项目或团队协作开发，简化了构建环境的配置。
什么是FetchContent？
CMake 3.14引入了FetchContent模块，它允许你在CMake脚本中声明外部依赖，并在配置阶段自动获取（如从Git仓库、tar包等），然后像普通子目录一样将其包含进项目中。
相比传统的ExternalProject_Add，FetchContent更简单直观，所有内容都在本地构建树中，支持直接链接目标（target_link_libraries），更适合现代CMake工作流。
基本用法：添加一个第三方库
以引入nlohmann/json为例，展示如何使用FetchContent：
立即学习“C++免费学习笔记（深入）”；
cmake_minimum_required(VERSION 3.14) project(MyApp) include(FetchContent) FetchContent_Declare( nlohmann_json GIT_REPOSITORY https://www.php.cn/link/b82e68e6366d4177332acdf3fa4d1e3a.git GIT_TAG v3.11.2 ) FetchContent_MakeAvailable(nlohmann_json)
上面代码做了三件事：
-
声明依赖源：通过
FetchContent_Declare指定Git地址和标签版本。 -
触发下载与配置：
FetchContent_MakeAvailable会下载内容并调用其CMakeLists.txt，使其成为项目的一部分。 -
可用性：之后就可以使用
nlohmann_json::nlohmann_json这样的目标进行链接。
接着在你的可执行文件中使用它：
add_executable(myapp main.cpp) target_link_libraries(myapp PRIVATE nlohmann_json::nlohmann_json)
支持多种获取方式
FetchContent_Declare支持多种来源：
-
Git仓库：使用
GIT_REPOSITORY和GIT_TAG（推荐使用确切tag）。 -
HTTP压缩包：
URL https://example.com/zipfile.zip。 -
本地路径：
SOURCE_DIR /path/to/local/dir，便于本地调试。
例如使用ZIP包：
FetchContent_Declare( fmt URL https://github.com/fmtlib/fmt/releases/download/10.0.0/fmt-10.0.0.zip ) FetchContent_MakeAvailable(fmt)
然后链接fmt::fmt即可。
优化体验的小技巧
- 避免重复下载：CMake会在构建目录中缓存已下载的内容，清理构建目录才会重新下载。
-
离线构建支持：可通过预设
SOURCE_DIR跳过网络请求，适合CI/CD或无网环境。 -
统一管理多个依赖：可将所有
FetchContent_Declare集中在一个dependencies.cmake文件中再include。 -
控制是否启用内部版本：结合
find_package()优先查找系统安装版本，找不到再用FetchContent回退：find_package(nlohmann_json 3.11.2 QUIET) if(NOT nlohmann_json_FOUND) FetchContent_Declare(...) FetchContent_MakeAvailable(nlohmann_json) endif()
基本上就这些。FetchContent让C++项目的依赖管理变得轻量又可靠，尤其适合中小型项目快速集成常用库。只要确保CMake版本够新，就能享受“开箱即用”的便捷体验。
