如何通过Conan将CMake项目链接到Boost::Python？解决配置报错

我有一个简单的main.cpp文件，想要使用boost/python.hpp头文件。此前我的CMake经验仅涉及target_include_directories或手动管理头文件/源文件，现在需要通过Conan获取Boost库，但无法将其链接到项目中。

现有代码与配置 #

main.cpp #

#include <iostream>

#include <boost/python.hpp>  

using namespace boost::python;  

int main()
{
    std::cout << "Hello World!";
}

CMakeLists.txt #

cmake_minimum_required(VERSION 3.10)

project(myMath)

list(APPEND CMAKE_MODULE_PATH "${PROJECT_SOURCE_DIR}/build/dependencies/conan")

find_package(Boost 1.72 CONFIG REQUIRED)

target_link_libraries(my_math Boost::python)

add_executable(my_math 
    main.cpp)

conanfile.txt #

[requires]
boost/1.83.0

[generators]
CMakeDeps
CMakeToolchain

操作步骤与报错 #

1. Conan安装命令：conan install conanfile.txt -of build/dependencies/conan
2. CMake GUI设置：
   • 源代码位置：.../Desktop/C++/BoostExample
   • 二进制文件构建位置：.../Desktop/C++/BoostExample/build/CMakeBuild

CMake持续报错，提示无法找到BoostConfig.cmake，而该文件实际存在于.../dependencies/conan目录中，已通过list(APPEND CMAKE_MODULE_PATH "${PROJECT_SOURCE_DIR}/build/dependencies/conan")配置路径。报错信息：

Could not find a package configuration file provided by "Boost" (requested
version 1.72) with any of the following names:

BoostConfig.cmake
boost-config.cmake

同时存在两个疑问：

• 还需哪些配置才能找到BOOST::Python？
• Conan为何未提供.hpp头文件？

一、CMake无法找到BoostConfig.cmake的修复 #

1. 修正版本不匹配问题 #

你的conanfile.txt声明依赖boost/1.83.0，但CMake中find_package(Boost 1.72 CONFIG REQUIRED)指定的是1.72版本，版本不一致导致CMake无法匹配到对应配置文件。修改CMake中的版本号：

find_package(Boost 1.83 CONFIG REQUIRED)

2. 移除手动路径配置，使用Conan Toolchain #

CMakeDeps生成的Boost配置文件会存放在build/dependencies/conan/lib/cmake/Boost-1.83.0这类子目录下，直接添加根目录到CMAKE_MODULE_PATH无效。正确做法是利用CMakeToolchain自动配置路径：

• 在CMake GUI的配置步骤中，找到CMAKE_TOOLCHAIN_FILE选项，设置为build/dependencies/conan/conan_toolchain.cmake（Conan生成的工具链文件）
• 删除CMakeLists.txt中list(APPEND CMAKE_MODULE_PATH ...)这一行

3. 调整目标创建与链接的顺序 #

CMake中target_link_libraries必须在add_executable之后执行，否则目标未创建就会报错。修正顺序：

add_executable(my_math 
    main.cpp)

target_link_libraries(my_math Boost::python)

二、Conan未提供.hpp头文件的说明 #

Boost是头文件优先的库，Conan安装Boost时，所有头文件已经存放在build/dependencies/conan/include目录下。之前找不到头文件是因为CMake路径配置错误，当CMake正确识别Boost配置后，Boost::python目标会自动引入头文件路径，无需手动添加target_include_directories。

最终修正后的CMakeLists.txt #

cmake_minimum_required(VERSION 3.10)

project(myMath)

find_package(Boost 1.83 CONFIG REQUIRED COMPONENTS python)

add_executable(my_math 
    main.cpp)

target_link_libraries(my_math Boost::python)

正确操作流程 #

1. 执行Conan安装命令：conan install conanfile.txt -of build/dependencies/conan
2. 打开CMake GUI，设置源代码与二进制构建目录
3. 点击Configure，在弹出的对话框中指定CMAKE_TOOLCHAIN_FILE为build/dependencies/conan/conan_toolchain.cmake
4. 再次点击Configure，完成后点击Generate
5. 编译项目即可

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