必须用 find_package 找到 boost 并用 target_link_libraries 显式链接组件，否则链接失败；find_package(boost required) 仅提供头文件，不自动链接库；需在 components 中明确指定 filesystem、system 等组件名，并确保 boost_root 和 boost_no_system_paths 设置正确。
直接说结论：必须用 find_package 找到 Boost，再用 target_link_libraries 显式链接组件，漏掉任意一步都会链接失败。
为什么 find_package(Boost REQUIRED) 不够用？
这行命令只保证 Boost 头文件可用，但不会自动把具体库（比如 libboost_filesystem）塞进链接器命令里。CMake 不会猜你要用哪些组件——哪怕你代码里写了 #include <boost></boost>，它也无动于衷。
- 常见错误现象：
undefined reference to `boost::filesystem::...'，编译通过但链接失败 - 正确做法：在
COMPONENTS后明确列出所有用到的库名，例如filesystem system - 组件名必须和库文件名后缀严格对应：
regex→libboost_regex，program_options→libboost_program_options - 如果用了
thread或chrono这类需要编译的库，还要确保你的构建环境已编译出对应二进制（头文件库如asio除外）
target_link_libraries 里该传 ${Boost_LIBRARIES} 还是单个目标？
优先用 ${Boost_LIBRARIES}，但前提是 find_package 已指定 COMPONENTS。否则 ${Boost_LIBRARIES} 可能为空或只含头文件库（如 boost_system 被误当成 header-only）。
- 不要写
target_link_libraries(myapp boost_filesystem)—— CMake 不认识裸库名，必须走变量或导入目标 - 现代写法（CMake ≥ 3.15）可改用
target_link_libraries(myapp PRIVATE Boost::filesystem Boost::system)，前提是find_package成功且 Boost 提供了 IMPORTED TARGET（通常需系统安装或 FetchContent 构建） - 若用
${Boost_LIBRARIES}，记得检查它的值：message(STATUS "LIBS = ${Boost_LIBRARIES}")，空值就说明COMPONENTS拼错或库未编译
找不到 Boost？先查这三个变量是否设对
尤其是当你把 Boost 装在非标准路径（如 /opt/boost_1_86_0 或项目内 third_party/boost）时，CMake 默认会跳过这些位置。
-
set(BOOST_ROOT "/path/to/boost_1_86_0")—— 必须指向解压后的根目录，不是include子目录 -
set(Boost_NO_SYSTEM_PATHS ON)—— 关键！否则 CMake 可能找到系统旧版（如 Ubuntu 的 1.74），导致 ABI 不兼容 -
set(BOOST_LIBRARYDIR "${BOOST_ROOT}/lib")和set(BOOST_INCLUDEDIR "${BOOST_ROOT}/include")—— 当库/头文件不在默认子目录时才需要，多数情况靠BOOST_ROOT就够 - 验证是否生效：加一行
message(STATUS "Boost include: ${Boost_INCLUDE_DIRS}")，输出路径应包含你设的BOOST_ROOT
最常被忽略的是 Boost_NO_SYSTEM_PATHS 开关——不关它，CMake 就可能在你完全没意识到的情况下，偷偷链接了系统里版本不匹配的 Boost，报错信息却只显示“undefined reference”，让人反复怀疑代码写错了。
