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：

cmake_minimum_required(VERSION 3.14)
project(MyApp)

include(FetchContent)

FetchContent_Declare(
  nlohmann_json
  GIT_REPOSITORY https://www./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版本够新，就能享受“开箱即用”的便捷体验。