如何链接其他目录中CMake生成的库？解决编译顺序问题

我之前也碰到过一模一样的情况——用add_subdirectory引入外部项目后，自己的项目先启动构建，结果找不到外部库。核心问题是CMake的构建顺序完全基于目标依赖关系自动推导，如果没明确告诉CMake你的项目依赖外部项目的库，它不会主动调整构建优先级。下面给你两个最实用的解决方案：

方案1：显式指定目标依赖（推荐，适用于外部项目在源码树内的场景） #

如果外部项目的CMakeLists.txt已经定义了明确的库目标（比如用add_library(external_lib ...)创建的目标），那只需要在你的项目中做好这几步：

1. 用add_subdirectory引入外部项目
2. 直接链接外部项目的库目标（而非手动写库文件路径）
3. 必要时显式添加add_dependencies强制构建顺序

举个具体的代码示例，你的项目根CMakeLists.txt可以这么写：

cmake_minimum_required(VERSION 3.10)
project(MyProject)

# 引入外部项目，第二个参数是构建输出目录（避免污染外部项目源码）
add_subdirectory(/path/to/my/other/project external_build_dir)

# 定义你的项目目标（比如可执行文件）
add_executable(my_app src/main.cpp)

# 关键：直接链接外部项目的库目标（这里的external_lib是外部项目CMakeLists.txt中add_library的目标名）
target_link_libraries(my_app PRIVATE external_lib)

# 如果上面的链接没自动触发依赖顺序，就显式添加这一行强制优先级
add_dependencies(my_app external_lib)

这样CMake就会明确知晓：要构建my_app，必须先完成external_lib的构建，从而自动调整顺序。

方案2：用ExternalProject_Add完全管理外部项目（适用于外部项目不在源码树或需要灵活控制的场景） #

如果外部项目不在你的源码目录下，或者你需要控制它的下载、编译、安装流程，ExternalProject_Add是更合适的选择。这个CMake模块会完全接管外部项目的构建生命周期，确保在你的项目启动前完成外部项目的编译和安装。

示例代码如下：

cmake_minimum_required(VERSION 3.10)
project(MyProject)

# 引入ExternalProject模块
include(ExternalProject)

# 定义外部项目的构建参数
ExternalProject_Add(
    external_project
    PREFIX ${CMAKE_BINARY_DIR}/external  # 外部项目的构建根目录
    SOURCE_DIR /path/to/my/other/project # 外部项目的源码路径
    # 传递给外部项目的CMake参数，比如指定安装目录
    CMAKE_ARGS -DCMAKE_INSTALL_PREFIX=${CMAKE_BINARY_DIR}/external/install
    # 如果外部项目需要特定编译选项，也可以在这里添加
)

# 找到外部项目安装后的库和头文件
find_library(EXTERNAL_LIB 
    NAMES external_lib 
    PATHS ${CMAKE_BINARY_DIR}/external/install/lib
    REQUIRED
)
find_path(EXTERNAL_INCLUDE 
    NAMES external_lib.h 
    PATHS ${CMAKE_BINARY_DIR}/external/install/include
    REQUIRED
)

# 定义你的项目目标
add_executable(my_app src/main.cpp)

# 强制先构建外部项目
add_dependencies(my_app external_project)

# 链接头文件和库
target_include_directories(my_app PRIVATE ${EXTERNAL_INCLUDE})
target_link_libraries(my_app PRIVATE ${EXTERNAL_LIB})

额外注意事项 #

• 确认外部项目的CMakeLists.txt中是否正确创建了库目标：如果它只是生成了库文件但没有用add_library定义目标，你需要先修改外部项目的CMake逻辑，或者改用方案2。
• 尽量避免手动指定库文件路径（比如/path/to/libexternal_lib.a），直接使用CMake目标名能让系统自动处理依赖和构建顺序，减少出错概率。

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