如何正确引入通过Homebrew安装的Boost库 解决头文件引用报错问题

• 头文件搜索路径配置错误：你在CMake中配置的include_directories(/opt/homebrew/Cellar)没有定位到Boost头文件的实际根目录。Homebrew安装的Boost头文件默认存放在/opt/homebrew/Cellar/boost/<版本号>/include路径下，编译器在你配置的路径下无法匹配到boost/multiprecision/cpp_int.hpp的相对路径，所以第一次引入头文件失败。
• 内部头文件引用规则限制：Boost内部所有头文件都是以boost/xxx.hpp的相对路径编写的，即使你手动写全路径引入了单个头文件，编译器还是无法在你配置的搜索路径下找到内部依赖的其他头文件，这就是第二个报错的直接原因。
• 链接配置存在错误：你配置的link_directories路径没有指向Boost库文件所在的lib目录，且target_link_libraries中直接写boost是错误的，Boost的库是分模块命名的，不存在名为boost的单库文件。

推荐使用CMake自带的FindBoost模块自动识别Boost路径，避免硬编码路径导致的适配问题，修改后的CMakeLists.txt配置如下：

cmake_minimum_required(VERSION 3.16)
project(Project)

# 适配Apple Silicon架构Mac的Homebrew路径，Intel架构可跳过该配置
set(CMAKE_PREFIX_PATH "/opt/homebrew" ${CMAKE_PREFIX_PATH})

# 查找指定版本的Boost，REQUIRED表示Boost是必选依赖
# 你使用的multiprecision是头文件-only模块，不需要额外指定组件
find_package(Boost 1.76.0 REQUIRED)

add_executable(Project main.cpp)

# 为目标添加Boost头文件搜索路径
target_include_directories(Project PRIVATE ${Boost_INCLUDE_DIRS})

# 如果你后续用到需要编译的Boost模块（如filesystem、system等），再添加下面这行
# target_link_libraries(Project PRIVATE ${Boost_LIBRARIES})

配置完成后代码直接使用标准引入方式即可：

#include <boost/multiprecision/cpp_int.hpp>
using namespace boost::multiprecision;

如果坚持使用硬编码路径的方式（不推荐，换版本/设备容易失效），可以将原CMake配置修改为：

# 直接指定Boost头文件根目录
include_directories(/opt/homebrew/Cellar/boost/1.76.0/include)
# 指定Boost库文件所在的lib目录
link_directories(/opt/homebrew/Cellar/boost/1.76.0/lib)
add_executable(Project main.cpp)
# 需要链接对应模块的库，比如用到system就写boost_system
# multiprecision是头文件-only模块，不需要额外链接
target_link_libraries(Project 对应需要的Boost模块库名)

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