如何解决Visual Studio中Boost 1.87更新后CMake无法识别的问题

问题背景 #

原Boost 1.86安装于C:\Dev\Boost_1_86_0，CMake配置正常运行。更新至Boost 1.87后（解压路径C:\Dev\Boost_1_87_0，已在VS2022开发者命令提示符执行b2 --clean-all -n、bootstrap、b2完成编译，系统环境变量BOOST_ROOT已更新为C:\Dev\Boost_1_87_0，CMake中修改find_package(Boost 1.87 REQUIRED)），CMake仍识别到旧版本1.86，报错无法找到符合要求的Boost 1.87。

解决步骤 #

1. 彻底清理CMake缓存 #

CMake会缓存之前的Boost查找结果，必须清除缓存后重新构建：

• 若采用out-of-source构建，直接删除项目的build目录
• 在VS中右键项目 → CMake → 清理缓存
• 手动删除项目根目录下的CMakeCache.txt文件

2. 确认环境变量生效 #

Windows环境变量修改后，需重启相关程序才能读取新值：

• 重启VS和所有打开的终端窗口
• 在VS2022开发者命令提示符中执行echo %BOOST_ROOT%，确认输出为C:\Dev\Boost_1_87_0

3. 在CMake中显式指定Boost路径 #

如果环境变量未被CMake正确读取，直接在CMakeLists.txt中硬编码指定路径，强制覆盖自动查找逻辑：

set(Boost_USE_MULTITHREADED ON)
set(Boost_USE_STATIC_LIBS ON)
if(MSVC)
    add_definitions("-DHAS_BOOST -D_WIN32_WINNT=0x0601")
endif()
set(Boost_DEBUG 1) 
# 显式指定Boost根目录
set(BOOST_ROOT "C:/Dev/Boost_1_87_0")
# 指定编译后的库目录（b2默认输出到stage/lib）
set(BOOST_LIBRARYDIR "${BOOST_ROOT}/stage/lib")
find_package(Boost 1.87 REQUIRED)
include_directories(${Boost_INCLUDE_DIR})

4. 验证Boost 1.87编译完整性 #

检查C:\Dev\Boost_1_87_0\stage\lib目录是否存在生成的静态库文件（如libboost_thread-vc143-mt-x64-1_87.lib），若为空则重新编译：
在VS2022开发者命令提示符中执行：

b2 --clean-all
bootstrap.bat
b2 toolset=msvc-14.3 architecture=x86 address-model=64 link=static threading=multi --build-type=complete

（toolset=msvc-14.3对应VS2022版本，确保与当前使用的编译器匹配）

5. 告知CMake Boost 1.87版本 #

部分CMake版本可能未内置Boost 1.87的版本识别，添加版本提示：
在find_package前加入：

set(Boost_ADDITIONAL_VERSIONS "1.87" "1.87.0")

内容的提问来源于stack exchange，提问作者qloq