如何在CMake C++项目中将Boost作为git子模块正确集成使用

结论 #

该需求完全可以实现，你遇到的报错和系统版本优先的问题来自两处操作疏漏：

1. 你指定的deps/boost/tools/boost_install/BoostConfig.cmake是Boost官方提供的配置模板文件，未携带版本信息也无法直接用于依赖索引，会触发版本未知报错。
2. 未给find_package添加禁止搜索系统路径的强制参数，导致CMake优先匹配全局安装的Boost版本。

推荐方案：通过add_subdirectory直接集成子模块 #

该方案完全不需要预编译Boost，也不会触发系统路径检索，是子模块集成Boost的最优选择：

步骤1：CMakeLists.txt 配置 #

cmake_minimum_required(VERSION 3.17)
project(test_boost)

# 配置Boost参数：仅编译需要的Graph组件，禁止搜索系统Boost
set(BOOST_INCLUDE_LIBRARIES graph)
set(BOOST_ENABLE_CMAKE ON)
set(Boost_NO_SYSTEM_PATHS ON)

# 原有fmt依赖集成
add_subdirectory(deps/fmt)
# 集成Boost子模块，第二个参数指定Boost构建产物输出路径，避免污染项目目录
add_subdirectory(deps/boost ${CMAKE_BINARY_DIR}/boost_build EXCLUDE_FROM_ALL)

add_executable(test_boost main.cpp)
# 链接依赖：fmt + Boost Graph
target_link_libraries(test_boost fmt::fmt Boost::graph)

步骤2：测试代码（main.cpp） #

#include <fmt/format.h>
#include <boost/graph/adjacency_list.hpp>

int main() {
    // 测试Boost Graph是否正常生效
    boost::adjacency_list<> test_graph;
    boost::add_vertex(test_graph);
    fmt::print("Boost Graph 集成成功，当前顶点数：{}\n", boost::num_vertices(test_graph));
    return 0;
}

步骤3：重新构建 #

注意要先清理之前的CMake缓存，避免旧配置残留：

rm -rf build
mkdir build && cd build
cmake ..
make -j$(nproc)

构建完成后运行二进制文件，会输出Boost Graph 集成成功，当前顶点数：1，验证集成正常。

备选方案：使用find_package集成（需预编译Boost） #

如果你坚持使用find_package方案，需要先预编译子模块内的Boost到本地目录：

步骤1：预编译Boost #

cd deps/boost
./bootstrap.sh --prefix=./local_install
./b2 install -j$(nproc)
cd ../..

步骤2：调整CMake配置 #

cmake_minimum_required(VERSION 3.17)
project(test_boost)

set(Boost_NO_SYSTEM_PATHS ON CACHE BOOL "" FORCE)
# 完全禁止CMake检索默认系统路径，只查找指定路径
find_package(Boost 1.77.0 REQUIRED COMPONENTS graph CONFIG 
    PATHS ${CMAKE_CURRENT_SOURCE_DIR}/deps/boost/local_install 
    NO_DEFAULT_PATH
)

add_subdirectory(deps/fmt)
add_executable(test_boost main.cpp)
target_link_libraries(test_boost fmt::fmt Boost::graph)

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