CMake中如何强制libs1→libs2→libs3→libs4按依赖顺序构建

这个问题我之前也碰到过——CMake默认会并行处理add_subdirectory的配置流程，导致依赖库还没完成构建，依赖它的子目录就开始执行查找验证逻辑，直接触发错误。针对你的链式依赖场景（libs1→libs2→libs3→libs4），这里有两种可行的解决方案：

方法一：直接关联目标（推荐，现代CMake最佳实践） #

如果可以调整libs2、libs3、libs4的CMake脚本，最稳妥的方式是放弃查找逻辑，直接依赖上游库的CMake目标。因为当你用add_subdirectory添加libs1后，它的目标会自动在父CMake的作用域中可见，下游库可以直接链接这些目标，CMake会自动处理构建顺序。

步骤： #

1. 在libs1的CMakeLists.txt中确保目标被正确定义：

add_library(libs1 [STATIC/SHARED] src/your_source_files.cpp)
# 如果需要导出目标给其他子目录使用（可选，若直接链接则不需要）
export(TARGETS libs1 FILE ${CMAKE_CURRENT_BINARY_DIR}/libs1Targets.cmake)

2. 父CMake中保持按依赖顺序添加子目录：

if(build_libs)
    add_subdirectory(libs1)  # 先添加依赖最底层的库
    add_subdirectory(libs2)
    add_subdirectory(libs3)
    add_subdirectory(libs4)
endif()

3. 修改libs2的CMakeLists.txt，直接链接libs1的目标，替换原有的查找逻辑：

add_library(libs2 [STATIC/SHARED] src/your_source_files.cpp)
# 直接链接libs1的目标，CMake会自动确保libs1先构建
target_link_libraries(libs2 PRIVATE libs1)

同理，libs3链接libs2，libs4链接libs3即可。这种方式完全利用CMake的目标依赖系统，不需要额外处理构建顺序，是最简洁的方案。

方法二：使用ExternalProject_Add（适配必须保留查找逻辑的场景） #

如果libs2、libs3、libs4的CMake脚本必须保留查找上游库的逻辑（比如find_package），那可以用ExternalProject_Add来强制链式构建顺序——它会先完成上游库的构建和安装，再启动下游库的配置和构建。

父CMake示例代码： #

include(ExternalProject)

# 定义安装目录，统一存放各库的构建产物
set(INSTALL_DIR ${CMAKE_CURRENT_BINARY_DIR}/external_install)

if(build_libs)
    # 构建libs1，安装到指定目录
    ExternalProject_Add(
        libs1_project
        SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/libs1
        CMAKE_ARGS 
            -DCMAKE_INSTALL_PREFIX=${INSTALL_DIR}
            # 可以添加其他libs1需要的CMake参数
        BUILD_ALWAYS OFF
    )

    # 构建libs2，依赖libs1_project的完成
    ExternalProject_Add(
        libs2_project
        SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/libs2
        CMAKE_ARGS 
            -DCMAKE_INSTALL_PREFIX=${INSTALL_DIR}
            -Dlibs1_DIR=${INSTALL_DIR}/lib/cmake/libs1  # 告诉libs2去哪里找libs1的配置
        DEPENDS libs1_project  # 强制先构建libs1
        BUILD_ALWAYS OFF
    )

    # 构建libs3，依赖libs2_project
    ExternalProject_Add(
        libs3_project
        SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/libs3
        CMAKE_ARGS 
            -DCMAKE_INSTALL_PREFIX=${INSTALL_DIR}
            -Dlibs2_DIR=${INSTALL_DIR}/lib/cmake/libs2
        DEPENDS libs2_project
        BUILD_ALWAYS OFF
    )

    # 构建libs4，依赖libs3_project
    ExternalProject_Add(
        libs4_project
        SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/libs4
        CMAKE_ARGS 
            -DCMAKE_INSTALL_PREFIX=${INSTALL_DIR}
            -Dlibs3_DIR=${INSTALL_DIR}/lib/cmake/libs3
        DEPENDS libs3_project
        BUILD_ALWAYS OFF
    )
endif()

这种方式会把每个库当作独立的外部项目，严格按照依赖顺序执行构建，确保下游库配置时上游库的构建产物已经存在，能通过查找验证。

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