最稳妥的起点是用 find_package(Boost) 并显式指定 COMPONENTS、控制查找路径，且需区分头文件与二进制库；漏掉任一环节会导致 target_link_libraries 静默失败或链接错误。
直接说结论：用 find_package(Boost) 是最稳妥的起点，但必须明确指定 COMPONENTS、控制查找路径、并理解 Boost 库分“头文件”和“二进制”两类——漏掉任一环节，target_link_libraries 就会静默失败或链接错误。
为什么 find_package(Boost) 找不到库或报错 COMPONENTS 未满足？
常见现象是 CMake 报错类似 Could not find the following Boost components: filesystem，或者 Boost_FOUND 为 FALSE。这不是 Boost 没装，而是 find_package 默认行为太“宽容”：
- 不加
REQUIRED时，找不到也继续执行，后续Boost_LIBRARIES为空，链接阶段才爆红 - 不写
COMPONENTS，它只查头文件路径，不会去搜.lib/.a；而像filesystem、system这类必须编译的组件，没显式列出来就等于“不存在” - Windows 下若用了预编译包，但
PATHS指向的目录里没有对应编译器版本（如vc143）和运行时（mt/md）的库文件，也会失败
Windows 预编译 Boost 怎么让 find_package 正确识别？
关键不是“放对路径”，而是让 CMake 知道“只在这里找”，避免它去系统默认路径（如 C:/Program Files/boost）撞上旧版本或残缺安装：
- 设置环境变量
BOOST_ROOT指向你的预编译根目录（例如D:/boost_1_75_0），并在 CMakeLists.txt 开头加cmake_policy(SET CMP0074 NEW)启用该变量优先级 - 调用
find_package时强制限定范围：find_package(Boost 1.70 REQUIRED COMPONENTS filesystem system PATHS ${BOOST_ROOT} NO_DEFAULT_PATH) - 确认
${BOOST_ROOT}/lib下存在形如boost_filesystem-vc143-mt-x64-1_75.lib的文件；若只有boost_filesystem.lib（无编译器标识），说明是通用命名，需额外设set(Boost_USE_STATIC_LIBS ON)或set(Boost_USE_MULTITHREADED ON)
Linux/macOS 上用系统包管理器装的 Boost 为何 find_package 还是失败？
Ubuntu/Debian 的 libboost-filesystem-dev 或 macOS Homebrew 的 boost 包，头文件和库常被拆到非标准位置（如 /usr/lib/x86_64-linux-gnu），CMake 默认不查：
- 别依赖
BOOST_ROOT，改用PATHS显式指定库路径：find_package(Boost 1.70 REQUIRED COMPONENTS filesystem PATHS /usr /usr/local /opt/homebrew) - 若仍失败，手动补全路径更可靠：
set(BOOST_INCLUDEDIR "/usr/include")和set(BOOST_LIBRARYDIR "/usr/lib/x86_64-linux-gnu")，再传给find_package(... PATHS ${BOOST_INCLUDEDIR} ${BOOST_LIBRARYDIR}) - 注意
BOOST_NO_SYSTEM_PATHS ON会禁用所有默认路径，一旦设了却没配全PATHS，就彻底找不到
用 Boost:: 别名链接 vs 直接用 ${Boost_LIBRARIES} 有什么区别？
本质是目标作用域和传递性问题。用 Boost::filesystem 是现代 CMake 推荐方式，但前提是 find_package 成功且版本 ≥ 1.65：
-
target_link_libraries(myapp PRIVATE Boost::filesystem)会自动把头文件路径、编译定义（如BOOST_FILESYSTEM_DYN_LINK）、甚至依赖的Boost::system一并传递，无需手动include_directories - 而
${Boost_LIBRARIES}只是一堆路径字符串，链接成功但不保证头文件可见；若项目有子模块，还得重复传${Boost_INCLUDE_DIRS} - 如果
find_package返回的是旧版 Boost（比如系统自带 1.58），Boost::别名根本不存在，CMake 会报Cannot find target "Boost::filesystem"
最容易被忽略的一点：Boost 的 filesystem 和 system 组件有强依赖关系，system 必须出现在 COMPONENTS 列表里，哪怕你代码里没直接调用它——否则链接时会提示 undefined reference 到 boost::system::system_category()。
