如何正确处理从源码拉取的大型CMake C++项目依赖？

你要的能力CMake原生已经支持，核心思路是优先查找系统预安装依赖，查找失败时自动从源码编译依赖到构建目录的私有前缀，全程兼容find_package调用逻辑，不需要使用add_subdirectory引入依赖的完整构建树。

推荐方案（CMake 3.24及以上版本，适配成本最低） #

使用CMake内置的FetchContent模块的FIND_PACKAGE_ARGS特性，实现find_package和源码编译的无缝衔接：

1. 所有依赖以git子模块的形式存放在项目的extern/等目录下，保证跨平台源码可获得
2. 配置阶段FetchContent会优先调用find_package查找系统已有的依赖，查找成功直接使用系统动态库
3. 查找失败时自动从你指定的子模块路径编译依赖，安装到构建目录下的私有前缀，后续find_package会直接定位到这个本地编译的版本

完整示例代码 #

cmake_minimum_required(VERSION 3.24 FATAL_ERROR)
project(MyCrossPlatformProject LANGUAGES CXX)

# 配置私有依赖安装路径，编译的依赖全部放在这里，不会污染系统环境
set(LOCAL_DEPS_INSTALL_DIR ${CMAKE_BINARY_DIR}/local_deps CACHE PATH "Local dependencies install root")
list(APPEND CMAKE_PREFIX_PATH ${LOCAL_DEPS_INSTALL_DIR})

# 全局设置优先编译动态库，和系统依赖行为保持一致
set(BUILD_SHARED_LIBS ON CACHE BOOL "Build shared libraries by default")

include(FetchContent)
# 示例：配置fmt依赖，使用本地子模块源码，优先查找系统版本
FetchContent_Declare(
  fmt
  SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/extern/fmt # 指向你的git子模块路径
  FIND_PACKAGE_ARGS NAMES fmt # 对接find_package(fmt)调用
)

# 批量声明所有需要的依赖，这里会自动执行「找系统包->找不到就编译」的逻辑
FetchContent_MakeAvailable(fmt spdlog yaml-cpp) # 把你所有依赖都列在这里

# 你的主项目代码，完全不需要修改原有链接逻辑
add_executable(my_app src/main.cpp)
target_link_libraries(my_app PRIVATE fmt::fmt spdlog::spdlog yaml-cpp::yaml-cpp)

兼容低版本CMake方案（3.24以下） #

如果需要兼容更低版本的CMake，可以使用ExternalProject_Add模块提前编译依赖到私有前缀：

• 在项目配置阶段用execute_process触发所有依赖的预编译，安装到${CMAKE_BINARY_DIR}/local_deps
• 将私有前缀路径加入CMAKE_PREFIX_PATH，后续find_package就可以正常找到预编译的依赖
• 依赖编译逻辑只在首次配置时执行一次，后续构建会直接复用预编译结果

优势说明 #

• 完全满足跨平台免手动安装依赖的要求，用户只需要执行git pull --recurse-submodules && cmake -B build && cmake --build build即可完成构建
• 依赖只会编译一次，不会像add_subdirectory一样每次构建都要检查依赖目标状态，链接速度和使用系统依赖完全一致
• 支持自定义编译配置，可以通过选项控制是否强制编译所有依赖、编译静态/动态库等，适配不同发布需求

内容的提问来源于stack exchange，提问作者mrAndersen