Boost需手动配置头文件路径和链接库：Linux/macOS用-I指定根目录，Windows在项目属性中设置附加包含目录；涉及系统调用的组件如filesystem需链接对应.lib/.a文件，并确保运行时库、架构与项目一致；推荐用CMake通过find_package(Boost REQUIRED COMPONENTS)和target_link_libraries自动集成。
Boost 不是“开箱即用”的标准库，它得自己编译、链接、配置头文件路径——没做这三步，#include <boost></boost> 会直接报错。
怎么让编译器找到 Boost 头文件
Boost 大部分组件是纯头文件（header-only），但编译器默认根本不知道 boost/ 在哪。你得告诉它。
- Linux/macOS：用
-I指定解压后的boost_1_85_0/根目录（不是boost_1_85_0/boost/） - Windows + MSVC：在项目属性 → C/C++ → 常规 → 附加包含目录里填完整路径，比如
C:\local\boost_1_85_0 - 别把
boost/子目录加进路径——否则#include <boost></boost>会变成#include <algorithm></algorithm>，找不到
哪些 Boost 组件要链接 .lib/.a 文件
头文件能搞定的只是 Boost 的一部分。像 boost::filesystem、boost::thread、boost::regex 这类涉及系统调用或复杂实现的，必须链接预编译库。
- 确认是否需要链接：查文档，看模块说明里有没有 “Requires linking with
libboost_filesystem” 这类提示 - 名字规则：Linux/macOS 是
-lboost_filesystem -lboost_system；Windows MSVC 是boost_filesystem-vc143-mt-x64-1_85.lib（带编译器、线程模型、架构、版本号） -
boost_system几乎总是依赖项——漏掉它，undefined reference to `boost::system::generic_category()`会立刻报出来
Windows 下常见链接失败原因
不是代码写错了，而是 Boost 库和你的项目“对不上号”。
立即学习“C++免费学习笔记（深入）”；
- 运行时库不一致：项目设了
/MD（动态 CRT），但 Boost 库是用/MT（静态 CRT）编译的 → 链接器拒绝合并 - 架构错位：x64 项目去链接 x86 的
.lib→LNK2001: unresolved external symbol且不提示具体架构问题 - 自动链接失效：MSVC 默认开启
#define BOOST_ALL_DYN_LINK或#define BOOST_LIB_DIAGNOSTIC能看到它到底在找哪个库名
用 CMake 正确集成 Boost（推荐方式）
手动配 -I 和 -l 容易出错，CMake 可以自动探测和适配。
- 必须用
find_package(Boost 1.70 REQUIRED COMPONENTS filesystem system)，不能只写find_package(Boost)—— 后者不保证组件可用 -
target_link_libraries(myapp PRIVATE Boost::filesystem Boost::system)才能正确传递编译选项和依赖顺序 - 如果
find_package找不到，设置BOOST_ROOT环境变量或 CMake 参数，比如-DBOOST_ROOT=C:/local/boost_1_85_0
Boost 的麻烦不在语法，而在环境一致性——头文件路径、库命名、运行时模型、CMake target 名字，四个地方只要一个没对齐，编译就停在第一步。动手前先跑 ls boost/ | head -3 或 dir boost 确认目录结构，比反复改 #include 实在得多。
