使用CMake搭配vcpkg配置时无法找到Boost variant2组件报错

boost-variant2 是纯头文件（Header-only）类型的Boost组件，不需要提前编译生成二进制库文件，不属于CMake内置FindBoost模块识别的、需要显式声明的可链接组件。你之前参考vcpkg提示写的配置，是针对需要单独编译的Boost组件（比如filesystem、thread这类）的写法，纯头文件组件既不需要列在find_package的COMPONENTS列表里，也不存在单独的Boost::variant2链接目标，所以CMake查找时会报组件缺失的错误。

• 修正CMakeLists.txt中的Boost配置，移除COMPONENTS段的variant2声明，纯头文件组件只需要链接Boost基础头文件目标即可，正确配置如下：

  find_package(Boost REQUIRED)
  target_link_libraries(MyTarget PRIVATE Boost::boost)
  

  配置完成后直接在代码里包含#include <boost/variant2/variant.hpp>即可正常使用，所有Boost纯头文件库（包括asio、uuid、variant2等）都可以通过这种方式引入，不需要额外指定组件。
• 执行vcpkg list boost-variant2命令检查安装状态，确认输出中存在boost-variant2:x64-windows的安装记录，排除装错架构（比如仅安装了x86版本）、安装未完成的问题。
• 清空项目的CMake构建缓存，删除build目录下的CMakeCache.txt文件，或者直接清空整个build目录后重新执行CMake配置命令，避免旧缓存中留存的错误查找结果干扰配置流程。
• 核对CMake命令中CMAKE_TOOLCHAIN_FILE指向的vcpkg路径，和你安装boost-variant2时使用的vcpkg是同一个实例，排除系统中存在多份vcpkg、路径指向错误导致找不到已安装包的问题。

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