fetchcontent是最轻量可控的第三方库集成方式，适用于支持cmake的库（如fmt、spdlog），需在project()后声明并调用fetchcontent_makeavailable，指定git_tag或url_hash确保构建稳定，避免target不可见或版本漂移问题。
用 FetchContent 下载并直接编译第三方库最省事
只要第三方库本身支持 CMake（比如 fmt、spdlog、catch2），FetchContent 是最轻量、最可控的方式。它不依赖系统包管理器，也不需要手动下载解压，所有操作都在 CMakeLists.txt 里声明清楚。
常见错误是把 FetchContent_Declare 放在 project() 之前，或没调用 FetchContent_MakeAvailable —— 这会导致目标不可见，链接时报 target not found。
-
FetchContent_Declare必须在project()之后、add_subdirectory或add_executable之前调用 - 推荐指定
GIT_TAG或URL_HASH，避免因远程仓库变更导致构建不稳定 - 如果库有自定义选项（如
SPDLOG_FMT_EXTERNAL），要在FetchContent_MakeAvailable前用set预设，否则默认值可能和你的项目冲突
include(FetchContent) FetchContent_Declare( fmt GIT_REPOSITORY https://github.com/fmtlib/fmt.git GIT_TAG 10.2.1 URL_HASH SHA256=7a9e85c4f5b5d9e9f4a6b1b3f1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1 ) set(FMT_INSTALL OFF CACHE BOOL "") FetchContent_MakeAvailable(fmt)
find_package 找已安装的系统库，但容易找不到
当你用 apt install libfmt-dev 或 brew install fmt 装过库，想复用时，find_package(fmt CONFIG REQUIRED) 理论上能自动定位。但实际中常失败，原因很具体：
- 系统安装路径不在
CMAKE_PREFIX_PATH默认搜索范围内（比如 Linux 上装在/usr/local，而 CMake 默认只查/usr） - 包名大小写不一致：有些库导出的是
Fmt而不是fmt，find_package区分大小写 - 版本号不匹配：
find_package(fmt 10.0 EXACT)会拒绝 10.2.1，除非你明确允许兼容
调试方法：运行 cmake -DCMAKE_VERBOSE_MAKEFILE=ON ..，看日志里 find_package 实际搜了哪些路径；或者临时加 message(STATUS "CMAKE_PREFIX_PATH=${CMAKE_PREFIX_PATH}") 确认环境变量是否生效。
自己打包成 ExternalProject_Add 适合复杂构建逻辑
当第三方库不支持 CMake（比如用 autotools 或自己写 makefile）、需要 patch 源码、或必须交叉编译时，ExternalProject_Add 是更底层但更灵活的选择。它本质是“在构建过程中执行一次外部构建”，比 FetchContent 多一层封装。
容易踩的坑是依赖顺序和接口暴露：它生成的是独立构建树，不会自动导出 target，必须手动用 add_library(... IMPORTED) + set_property 把头文件路径和链接信息传出来。
- 务必设置
STEP_TARGETS和DEPENDS明确构建阶段依赖关系，否则可能并行构建出错 -
CONFIGURE_COMMAND和BUILD_COMMAND中的路径要用${CMAKE_BINARY_DIR}而非${CMAKE_SOURCE_DIR}，避免污染源码树 - 若需导出 include 目录，得在
INSTALL_COMMAND后手动file(COPY ... DESTINATION ...)，不能指望它自动做
别硬套 vcpkg 或 conan——除非团队已统一工具链
这两个工具确实能解决依赖管理，但引入它们会把简单问题复杂化：vcpkg 要全局安装、修改环境变量、生成 toolchain 文件；conan 需要额外配置 profile、remote、lock 文件。对单人小项目或 CI 构建来说，维护成本远高于收益。
真正值得用的场景只有一个：你和同事共用同一套依赖版本，且已有成熟的 vcpkg.json 或 conanfile.py 流程。否则，优先选 FetchContent，它不增加新工具链、不改变构建命令、所有逻辑都在一个 CMakeLists.txt 里可读可查。
最常被忽略的是：哪怕用了 vcpkg，也要在 CMakeLists.txt 里显式调用 find_package，且必须指定 CONFIG 模式——漏掉 CONFIG 就会 fallback 到模块模式，大概率失败。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
