最可靠的方式是用 find_package(Boost REQUIRED COMPONENTS ...)，但需确保 Boost 已安装、路径可被 CMake 找到且组件名拼写准确，否则报错为“找不到 target”或“no known components”。
直接说结论：用 find_package(Boost REQUIRED COMPONENTS ...) 是最可靠的方式，但必须确保 Boost 已安装、路径可被 CMake 找到，且组件名拼写准确 —— 否则报错不是“找不到库”，而是“找不到 target”或“no known components”。
为什么 find_package(Boost) 总是失败？
常见现象：CMake 报错 Could NOT find Boost (missing: system filesystem) 或 Unknown argument COMPONENTS。根本原因不是 Boost 没装，而是 CMake 根本没走到查找逻辑里。
-
find_package默认只查系统路径（如/usr/lib、C:\Program Files\boost），不会自动读BOOST_ROOT环境变量（除非你显式启用策略） - Windows 上预编译包若解压在非标准路径（如
D:\boost_1_80_0），不加PATHS参数就必然失败 -
COMPONENTS后面写的名称必须和 Boost 官方组件名完全一致：filesystem✅，file_system❌，fs❌ - CMake 版本太低（REQUIRED COMPONENTS 语法不识别，报错位置很误导人
find_package 的 PATHS 和 NO_DEFAULT_PATH 怎么配？
当你把 Boost 放在自定义路径（比如 E:\deps\boost_1_80_0）时，必须告诉 CMake “只在这儿找”，否则它会先去系统路径搜一圈再放弃。
- 正确写法（Windows 预编译包）：
find_package(Boost 1.80 REQUIRED COMPONENTS filesystem system PATHS "E:/deps/boost_1_80_0" NO_DEFAULT_PATH) -
PATHS后跟的是 Boost 根目录（含include/boost/和lib/子目录），不是include或lib单独路径 -
NO_DEFAULT_PATH必须放在最后，否则会被忽略；加了它，CMake 就不会再去/usr/local或注册表里翻 - Linux/macOS 若用
sudo make install装到/usr/local，通常不用指定PATHS，但要确认pkg-config是否可用（影响Boost_LIBRARIES值是否完整）
链接时用 Boost::system 还是 ${Boost_LIBRARIES}？
推荐无条件用 Boost::system 这种 modern target 写法，${Boost_LIBRARIES} 是旧式变量引用，容易漏依赖或链接顺序错乱。
-
target_link_libraries(myapp PRIVATE Boost::filesystem Boost::system)✅ 自动带头文件路径、正确链接顺序、隐式传递BOOST_ALL_DYN_LINK宏（Windows 动态链接时必需） -
target_link_libraries(myapp PRIVATE ${Boost_LIBRARIES})❌ 在某些 Boost 版本下Boost_LIBRARIES可能为空，或只含 .lib 不含 .dll 导入库，导致链接通过但运行时报 DLL 找不到 - 如果 CMake 报错
Target "Boost::filesystem" not found，说明find_package没成功（不是拼写错，就是COMPONENTS指定的库没在你的 Boost 安装包里） - 静态链接需额外加
set(Boost_USE_STATIC_LIBS ON)，且预编译包必须包含 static 库（很多 Windows 二进制包默认只提供 shared）
Windows 上动态链接 DLL 怎么不崩？
即使 find_package 成功、链接通过、程序编译出来，运行时仍可能弹窗报“缺少 boost_filesystem-vc143-mt-x64-1_80.dll” —— 这不是 CMake 配置问题，是运行时环境缺失。
- 确保 DLL 文件实际存在：检查
boost_1_80_0/lib下是否有对应命名的.dll（注意 vs 版本、MT/MD、x86/x64 匹配） - 运行前把 DLL 所在目录加进系统
PATH，或者复制到 exe 同目录（开发阶段最简单） - 不要依赖
Boost_LIBRARY_DIRS变量去设置PATH—— 它只是构建时用，不影响运行时 - Clion/VS 等 IDE 的调试器默认不继承系统 PATH，需在 Run Configuration 里手动添加 DLL 路径
最容易被忽略的点：Boost 组件名大小写敏感、NO_DEFAULT_PATH 位置不能错、DLL 名称和编译器工具链强绑定。配通一次后，换台机器或换个 Boost 版本，大概率又要调一遍 PATHS 和 toolset 参数。
