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