如何在Pybind11项目中正确调用Boost C++库的全部函数？

我明白你现在的困扰——已经把Boost放到项目的thirdparty目录，但直接用完整路径include头文件时，依赖的Boost头找不到。其实核心问题是没有在CMakeLists.txt中正确配置Boost的包含路径，导致编译器无法解析Boost内部的相对引用。下面一步步帮你解决：

1. 调整CMakeLists.txt配置 #

首先，你需要告诉CMake Boost库的位置，并将它的头目录添加到项目的包含路径中。因为你用的gauss_kronrod.hpp属于Boost Math模块，是**仅头文件（header-only）**的库，不需要链接编译后的库文件，只需要配置include路径即可。

这里是一个适配你的项目的完整CMakeLists.txt示例：

cmake_minimum_required(VERSION 3.14)
project(_test)

# 查找Pybind11（如果是通过pip安装的，CMake会自动找到；如果是本地源码，需要指定路径）
find_package(pybind11 REQUIRED)

# 指定Boost库的根目录（对应你项目中thirdparty下的boost文件夹）
set(BOOST_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/boost")
# 查找Boost，因为是仅头文件库，无需指定COMPONENTS
find_package(Boost REQUIRED)

# 创建Pybind11模块
add_library(_test MODULE your_source_file.cpp)

# 链接Pybind11模块，并添加Boost的包含路径
target_link_libraries(_test PRIVATE pybind11::module)
target_include_directories(_test PRIVATE ${Boost_INCLUDE_DIRS})

# 设置Python模块的输出属性（保证生成的文件符合Python模块格式）
set_target_properties(_test PROPERTIES 
    OUTPUT_NAME "_test"
    PREFIX "${PYTHON_MODULE_PREFIX}"
    SUFFIX "${PYTHON_MODULE_EXTENSION}"
)

2. 修改C++代码中的Include语句 #

配置好CMake后，你就不需要写冗长的完整路径了，直接用Boost标准的include方式即可：

#include <pybind11/pybind11.h>
#include <pybind11/numpy.h>
#include <boost/math/quadrature/gauss_kronrod.hpp> // 现在能正常找到啦

namespace py = pybind11;
namespace boost_math = boost::math::quadrature;

// 示例：封装gauss_kronrod的功能
double integrate_func(double a, double b) {
    auto f = [](double x) { return x * x; };
    return boost_math::gauss_kronrod<double, 31>::integrate(f, a, b, 1e-8);
}

PYBIND11_MODULE(_test, m) {
    m.def("integrate", &integrate_func, "用Boost的Gauss-Kronrod方法积分");
}

3. 为什么之前的方式会失败？ #

你之前用#include <thirdparty/boost/boost/math/quadrature/gauss_kronrod.hpp>时，虽然能找到这个头文件，但它内部会引用其他Boost头（比如<boost/math/tools/config.hpp>），这些引用都是以boost/xxx.hpp的形式写的。编译器此时不知道要去thirdparty/boost目录下找这些头，自然会报找不到依赖的错误。

而你提到的Boost cpp_int示例，他们也是通过类似的CMake配置，把Boost的根目录（即包含boost子文件夹的目录）添加到了项目的include路径中，所以#include <boost/multiprecision/cpp_int.hpp>能正常生效。

4. 额外注意事项 #

如果后续你用到Boost需要编译的模块（比如boost::thread、boost::system），只需要在find_package(Boost)时指定对应的组件即可，例如：

find_package(Boost REQUIRED COMPONENTS thread system)
# 同时需要链接这些库
target_link_libraries(_test PRIVATE pybind11::module ${Boost_LIBRARIES})

现在重新生成构建文件（比如cmake ..）并编译，你的Pybind11模块应该就能正常调用Boost的函数了！

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