使用MinGW-w64交叉编译时，CMake找到Boost却无法包含组件报错

问题场景与错误信息 #

交叉编译时出现头文件缺失错误：

fatal error: boost/math/special_functions/gamma.hpp: No such file or directory
21 | #include <boost/math/special_functions/gamma.hpp>

不使用MinGW-w64工具链时编译正常。

相关配置信息 #

工具链文件（MinGW-w64-x86_64.cmake） #

set(CMAKE_SYSTEM_NAME Windows)
set(TOOLCHAIN_PREFIX x86_64-w64-mingw32)

# cross compilers to use for C, C++ and Fortran
set(CMAKE_C_COMPILER ${TOOLCHAIN_PREFIX}-gcc)
set(CMAKE_CXX_COMPILER ${TOOLCHAIN_PREFIX}-g++)
set(CMAKE_Fortran_COMPILER ${TOOLCHAIN_PREFIX}-gfortran)
set(CMAKE_RC_COMPILER ${TOOLCHAIN_PREFIX}-windres)


# target environment on the build host system
set(CMAKE_FIND_ROOT_PATH /usr/${TOOLCHAIN_PREFIX})

# modify default behavior of FIND_XXX() commands
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)

编译命令 #

cmake -DCMAKE_TOOLCHAIN_FILE=/usr/include/mingw-w64-x86_64.cmake  /path to project/

CMakeLists.txt相关配置 #

set(Boost_INCLUDE_DIR /usr/include)
find_package(Boost REQUIRED)

问题分析与解决 #

错误核心原因：
你手动指定了Boost_INCLUDE_DIR为/usr/include，这是主机系统的Boost头文件路径，但交叉编译时工具链配置强制CMake仅从/usr/x86_64-w64-mingw32下查找头文件和库，因此无法找到主机路径下的文件。另外，主机的Boost是针对当前系统编译的，即便强行让编译器找到，也不兼容Windows目标平台。

解决步骤：

1. 删除硬编码的路径设置：移除CMakeLists.txt中的set(Boost_INCLUDE_DIR /usr/include)，让find_package(Boost)根据工具链配置自动查找目标平台的Boost库。
2. 安装目标平台的Boost库：安装针对Windows x86_64的MinGW版Boost包，例如Debian/Ubuntu系统可安装libboost-all-dev:x86_64-w64-mingw32，安装后头文件会被放置在/usr/x86_64-w64-mingw32/include目录，符合工具链的查找规则。
3. 明确Boost组件（可选）：如果项目依赖特定Boost组件，在find_package中指定组件名，比如find_package(Boost REQUIRED COMPONENTS math)，帮助CMake精准定位所需文件。
4. 验证路径存在性：确认/usr/x86_64-w64-mingw32/include/boost/math/special_functions/gamma.hpp存在，若不存在则说明目标平台Boost未正确安装。

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