如何捕获CMake中FetchContent_Declare命令的执行失败状态？

首先明确：FetchContent_Declare 仅用于声明依赖的配置信息，不会实际触发网络请求、源码下载等操作，真正执行拉取动作的是后续的FetchContent_Populate或FetchContent_MakeAvailable调用，因此需要在填充阶段捕获执行状态。

完整实现示例 #

以下是支持「远程拉取->查找系统预装版本」降级逻辑的代码，适配你的Eigen使用场景：

cmake_minimum_required(VERSION 3.18) # 最低依赖要求，RESULT_VARIABLE参数从该版本开始支持
include(FetchContent)

# 声明主源配置
FetchContent_Declare(
        Eigen
        GIT_REPOSITORY https://gitlab.com/cantonios/eigen
        GIT_TAG 3.4.0
        GIT_SHALLOW TRUE
        GIT_PROGRESS TRUE
        OVERRIDE_FIND_PACKAGE # 可选配置：开启后后续find_package会优先使用拉取的版本
)

# 手动执行填充步骤，捕获执行结果
set(FETCHCONTENT_TRY_FIND_PACKAGE_MODE NEVER)
FetchContent_Populate(Eigen
        RESULT_VARIABLE EIGEN_FETCH_STATUS # 填充成功时变量为空，失败时存储错误信息
        QUIET # 首次拉取可静默执行，避免冗余日志输出
)

if(EIGEN_FETCH_STATUS)
    message(WARNING "远程拉取Eigen失败，尝试查找系统预装版本，错误信息：${EIGEN_FETCH_STATUS}")
    # 执行find_package逻辑
    find_package(Eigen3 3.4 REQUIRED)
else()
    # 拉取成功，正常完成依赖导入
    FetchContent_MakeAvailable(Eigen)
endif()

扩展场景说明 #

• 如需新增镜像源降级逻辑，可在拉取失败的分支中，重新调用FetchContent_Declare替换为镜像地址后再次执行FetchContent_Populate，可通过列表循环实现多镜像轮询
• 如需兼容3.18以下版本的CMake，可先通过execute_process手动执行git clone测试仓库连通性，根据返回结果选择依赖引入逻辑
• 可通过设置FETCHCONTENT_SOURCE_DIR_EIGEN全局变量，支持用户手动指定本地Eigen源码路径，完全跳过网络拉取步骤，适配离线构建场景

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