CMake 3.30+ 默认启用 CMP0167 NEW 策略，强制优先使用 Boost 自带的 BoostConfig.cmake（Config 模式），若 Boost_ROOT 未指向含 lib/cmake/Boost-*/ 的父目录（如 D:/boost_prebuilt），则既不触发 Config 模式又不回退旧逻辑，导致 find_package(Boost) 静默失败。
直接用 find_package(Boost) 很大概率失败，不是路径没设对，而是 CMake 和 Boost 的版本协同逻辑变了——尤其在 3.30+ 和 Boost 1.70+ 组合下，旧式查找逻辑已被官方标记为“过时”。
为什么 find_package(Boost) 总是找不到库？
核心原因是 CMake 3.30 起默认启用 CMP0167 策略：它强制优先走 Boost 自带的 BoostConfig.cmake（即 Config 模式），而这个文件藏在预编译包的深层目录里，比如：lib/cmake/Boost-1.89.0/BoostConfig.cmake。如果你只把 Boost_ROOT 指向解压根目录（如 D:/boost_1_89_0），CMake 根本不会进去翻子目录。
- 现象：报错
Could NOT find Boost (missing: filesystem system)，即使库文件明明存在 - 根本原因：CMake 没触发 Config 模式，又因
CMP0167 NEW主动跳过了旧的FindBoost.cmake回退逻辑 - 验证方法：在
CMakeLists.txt开头加message(STATUS "CMAKE_VERSION: ${CMAKE_VERSION}")，确认是否 ≥ 3.30
Boost_ROOT 应该指向哪一级目录？
必须指向包含 lib/cmake/Boost-*/ 的父目录，不是源码根目录，也不是 include/ 所在目录。典型正确路径示例：
- vcpkg 安装后：
D:/vcpkg/installed/x64-windows（里面含lib/cmake/Boost-1.89.0/） - 手动预编译包：
D:/boost_prebuilt，且其结构为：D:/boost_prebuilt/lib/cmake/Boost-1.89.0/BoostConfig.cmake - 绝对不要设成：
D:/boost_1_89_0（这是源码目录，没有 Config 文件）
设错会导致 CMake 直接放弃 Config 模式，又不回退，最终静默失败。
如何让 CMake 强制走 Config 模式？
三步关键操作，缺一不可：
- 在
find_package()前加策略声明：cmake_policy(SET CMP0167 NEW) - 显式设置
Boost_ROOT为 Config 目录父路径：set(Boost_ROOT "$ENV{BOOST_ROOT}" CACHE PATH "")（或硬编码） - 调用时指定
CONFIG关键字：find_package(Boost 1.70 REQUIRED CONFIG COMPONENTS filesystem system)
注意：REQUIRED CONFIG 是硬性要求；漏掉 CONFIG 就会退回到已弃用的 Find 模式，大概率报错。
静态链接时 dll 和 lib 文件怎么配？
Windows 下静态链接 Boost（link=static）仍需注意运行时依赖。常见坑点：
- MSVC 工具链下，库名含
-vc143-mt-s-x64-1_89.lib后缀，其中s表示 static runtime，mt表示多线程；若项目用/MD（动态 CRT），则必须选-mt不带s的库 - MinGW 编译的库名含
-mgw11-mt-x64-1_89.a，mgw11对应 GCC 11，工具链不匹配会链接失败 - 动态链接时，DLL 必须在运行时 PATH 中，仅靠
target_link_libraries()不够；建议用add_compile_definitions(BOOST_ALL_DYN_LINK)显式启用 DLL 导入
最易被忽略的是：不同工具链（MSVC vs MinGW）生成的 Boost 库完全不兼容，混用必然链接失败——连错误信息都可能只显示“LNK2019”，根本看不出根源是工具链错配。
