CMake(C++)：如何将主项目链接至已单独构建的第三方依赖？

项目背景 #

项目结构如下：

MyProject
|- proj_folder1 (功能模块)
|---- files/subdirectories
|-----CMakeLists
|- proj_folder2 (功能模块)
|---- files/subdirectories
|-----CMakeLists
|- proj_folder3 (功能模块)
|---- files/subdirectories
|-----CMakeLists
|- 3rd_party_dependencies
|---- 各类依赖子目录（googletest, abseil-cpp, simdjson等）
|---- CMakeLists
|- CMakeLists

原顶层CMakeLists仅通过add_subdirectory引入依赖和子模块，已通过以下命令将第三方依赖独立构建至服务器全局路径：

cmake -GNinja -B /location_to_store_artifacts ./3rd_party_dependencies

解决方案步骤 #

1. 完成依赖的全局安装（推荐） #

仅构建生成中间产物不足以让主项目便捷引用，执行安装步骤将头文件、库文件和CMake配置统一放到全局目录：

# 进入依赖构建目录
cd /location_to_store_artifacts
# 若之前未指定安装路径，可重新配置时添加CMAKE_INSTALL_PREFIX指定全局路径
# cmake -DCMAKE_INSTALL_PREFIX=/opt/my_global_deps .
ninja install

/opt/my_global_deps替换为服务器上实际的全局可访问路径。

2. 修改主项目顶层CMakeLists.txt #

删除原文件中的add_subdirectory(3rd_party_dependencies)，根据依赖类型选择以下方式引入：

方式一：用find_package导入（主流依赖优先选择）

googletest、abseil、simdjson这类主流库都支持CMake的find_package机制，操作如下：

• 主项目配置命令（指定依赖安装路径）：

cmake -GNinja -B build -DCMAKE_PREFIX_PATH=/opt/my_global_deps .

• 顶层CMakeLists修改：

# 替换原来的add_subdirectory(3rd_party_dependencies)
find_package(GTest REQUIRED)
find_package(absl REQUIRED)
find_package(simdjson REQUIRED)

子模块中原来链接依赖的代码（如target_link_libraries(my_target GTest::GTest)）无需修改，find_package会自动导入对应的目标。

方式二：直接导入依赖的CMake导出文件

如果某些依赖不支持find_package，可以直接包含依赖构建目录中的导出配置：

# 替换原来的add_subdirectory(3rd_party_dependencies)
# 导入依赖的安装配置
include(/location_to_store_artifacts/cmake_install.cmake)
# 部分依赖会生成单独的Targets文件，可直接引入，比如：
# include(/opt/my_global_deps/lib/cmake/libhv/libhvTargets.cmake)

3. 验证与排错 #

执行主项目构建命令cd build && ninja，如果出现头文件或库找不到的情况，可补充指定路径：

cmake -GNinja -B build \
-DCMAKE_PREFIX_PATH=/opt/my_global_deps \
-DCMAKE_INCLUDE_PATH=/opt/my_global_deps/include \
-DCMAKE_LIBRARY_PATH=/opt/my_global_deps/lib .

关键注意点 #

• 依赖和主项目的编译选项（C++标准、编译器、架构）必须一致，否则会出现链接错误。
• 依赖更新时，只需重新构建安装依赖，主项目重新执行CMake配置即可，无需修改代码。

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