CMake中ExternalProject_Add依赖无法自动构建问题求助

问题原因 #

直接使用add_dependencies(${PROJECT_NAME} fmt-build)无效的核心原因是：测试目标在配置阶段就尝试链接尚未生成的libfmt.a，CMake会提前检查库文件是否存在，此时fmt-build还未执行，因此直接报错，根本无法进入构建阶段处理依赖关系。

解决方案（基于ExternalProject_Add） #

通过手动创建导入库目标，将库的路径检查延迟到构建阶段，同时让导入目标依赖fmt-build，确保构建测试程序前先完成fmt的编译安装。

修改后的CMakeLists.txt示例 #

cmake_minimum_required(VERSION 3.14)
project(test)

include(ExternalProject)

# 下载、编译并安装fmt到指定目录
ExternalProject_Add(
    fmt-build
    URL https://github.com/fmtlib/fmt/archive/refs/tags/8.1.1.tar.gz
    URL_HASH SHA256=7c88e695d99381f20f40d365c725857e19c17a4675d46a385828b4974e49f2d0
    CMAKE_ARGS 
        -DCMAKE_INSTALL_PREFIX=${CMAKE_CURRENT_BINARY_DIR}/fmt_install
        -DFMT_TEST=OFF  # 关闭fmt自身测试，加快构建
        -DCMAKE_BUILD_TYPE=${CMAKE_BUILD_TYPE}
)

# 获取fmt的安装目录
ExternalProject_Get_property(fmt-build INSTALL_DIR)
set(FMT_INSTALL_DIR ${INSTALL_DIR})

# 创建导入的静态库目标（全局可见）
add_library(fmt::fmt STATIC IMPORTED GLOBAL)
# 配置导入目标的属性：库路径和头文件目录（适配多平台）
set_target_properties(fmt::fmt PROPERTIES
    IMPORTED_LOCATION $<IF:$<PLATFORM_ID:Windows>,${FMT_INSTALL_DIR}/lib/fmt.lib,${FMT_INSTALL_DIR}/lib/libfmt.a>
    INTERFACE_INCLUDE_DIRECTORIES ${FMT_INSTALL_DIR}/include
)

# 让导入目标依赖fmt-build，确保先构建fmt
add_dependencies(fmt::fmt fmt-build)

# 构建测试程序
add_executable(${PROJECT_NAME} main.cpp)
# 链接导入的fmt目标，CMake会自动处理依赖顺序
target_link_libraries(${PROJECT_NAME} PRIVATE fmt::fmt)

更简洁的替代方案：使用FetchContent #

CMake 3.14+提供的FetchContent模块比ExternalProject_Add更易用，它会自动导入fmt的原生CMake目标，无需手动处理依赖：

cmake_minimum_required(VERSION 3.14)
project(test)

include(FetchContent)

FetchContent_Declare(
    fmt
    URL https://github.com/fmtlib/fmt/archive/refs/tags/8.1.1.tar.gz
    URL_HASH SHA256=7c88e695d99381f20f40d365c725857e19c17a4675d46a385828b4974e49f2d0
)

# 自动下载、编译fmt并导入其目标
FetchContent_MakeAvailable(fmt)

add_executable(${PROJECT_NAME} main.cpp)
target_link_libraries(${PROJECT_NAME} PRIVATE fmt::fmt)

关键说明 #

• 使用导入库目标时，CMake在配置阶段不会验证库文件是否存在，仅在构建阶段执行链接操作，此时fmt-build已完成，库文件生成完毕。
• FetchContent本质上封装了ExternalProject_Add，但直接集成了目标导入逻辑，代码更简洁且不易出错。

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