Boost安装后需验证路径并手动指定-I头文件路径，Linux/macOS检查对应include/boost/目录，Windows需手动编译；编译时用-I而非依赖pkg-config；推荐用vcpkg/conan或CMake的find_package自动管理路径与链接。
确认 Boost 是不是真的装了
很多人以为 apt install libboost-all-dev 或 brew install boost 跑完就万事大吉，其实不一定。比如 Ubuntu 的包可能只装头文件，没装某些组件；macOS 用 Homebrew 装的 Boost 默认路径又和 GCC/Clang 默认搜索路径不匹配。
先验证安装结果：
- Linux：检查
/usr/include/boost/或/usr/local/include/boost/是否存在xxx.hpp（比如filesystem.hpp） - macOS：Homebrew 默认装在
/opt/homebrew/include/boost/（Apple Silicon）或/usr/local/include/boost/（Intel），ls /opt/homebrew/include/boost/ | head -n 3看一眼 - Windows + MSVC：Boost 官网下载后需手动
b2编译，头文件在解压目录的boost/子目录，不会自动进系统路径
编译时怎么加头文件路径
错误本质是编译器找不到 boost/xxx.hpp，所以得告诉它去哪找。不是改环境变量，是让 g++ 或 clang++ 明确带 -I 参数。
常见写法：
立即学习“C++免费学习笔记（深入）”；
-
g++ -I /usr/local/include main.cpp（Linux/macOS 手动指定） -
g++ -I /opt/homebrew/include main.cpp（M1/M2 Mac） -
g++ -I C:\local\boost_1_84_0 main.cpp（Windows，注意路径分隔符不影响） - CMake 里写：
include_directories(/opt/homebrew/include)或更推荐的target_include_directories(my_target PRIVATE /opt/homebrew/include)
别用 -I /usr/include 这种泛路径——它里面没有 boost/，反而可能干扰系统头文件顺序。
为什么 pkg-config boost_filesystem 不起作用
pkg-config --cflags boost_filesystem 返回空或报错，不代表 Boost 没装，而是因为 Boost 大部分库是 header-only（比如 boost/algorithm/string.hpp），不需要链接；而 pkg-config 主要为需要链接的库（如 filesystem、system）提供信息，且很多发行版不给 Boost 提供 .pc 文件。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
所以：
- 纯头文件库（如
boost/optional.hpp）：只靠-I就行，不用pkg-config - 需要链接的库（如
boost::filesystem）：除了-I，还得-lboost_filesystem -lboost_system，路径用-L补（比如-L /usr/lib/x86_64-linux-gnu） - 别指望
pkg-config boost_headers—— 它不存在
用 conan/vcpkg/cmake find_package 怎么避开路径问题
手动管 -I 容易漏、难维护，尤其跨平台时。现代做法是交给包管理器处理路径。
示例（CMake + vcpkg）：
find_package(Boost REQUIRED COMPONENTS filesystem system) target_link_libraries(myapp PRIVATE Boost::filesystem Boost::system)
前提是已运行 vcpkg install boost-filesystem boost-system 并配置好 toolchain。Conan 类似，关键是 conanfile.txt 里声明依赖后，CMake 会自动注入 include_directories 和 link_libraries。
注意点：
- 如果
find_package(Boost)报 “Could not find Boost”，说明 CMake 没扫到你装的 Boost —— 检查BOOST_ROOT环境变量是否指向正确根目录（比如export BOOST_ROOT=/opt/homebrew） -
find_package默认只搜系统路径，不自动认 Homebrew 或手动安装位置 - Windows 上 MSVC 工具链和 vcpkg triplet（如
x64-windows）必须匹配，否则头文件和库架构对不上
最常被忽略的是：Boost 版本差异导致头文件名微调（比如 boost/filesystem.hpp 在旧版叫 boost/filesystem/v3.hpp），但只要路径对、版本不跨大代（1.70+），基本不影响 #include 写法。
