如何通过vcpkg和CMake使用Boost静态库并解决路径错误？

我之前也踩过一模一样的坑！问题核心出在vcpkg triplet与CMake配置的匹配上，再加上一些CMake写法的细节，咱们一步步来搞定：

1. 给CMake指定正确的vcpkg Triplet #

你安装的是boost:x64-windows-static静态库版本，但vcpkg的toolchain默认会使用x64-windows（动态库triplet），这就导致CMake依然去动态库目录找文件。所以运行CMake时必须明确指定triplet参数：

cmake .. -DCMAKE_TOOLCHAIN_FILE=C:\vcpkg\scripts\buildsystems\vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-windows-static

这个参数会告诉vcpkg我们要使用静态依赖，它会自动帮你定位到C:\vcpkg\installed\x64-windows-static下的静态Boost库。

2. 改用Modern CMake的Target写法（更可靠） #

你原来的CMakeLists.txt写法偏传统，用vcpkg的话完全可以不用手动处理include和link目录，直接链接Boost的官方targets就行，能彻底避免路径错误。修改你的配置：

# 必须在find_package之前设置，配合triplet使用更保险
set(Boost_USE_STATIC_LIBS ON)
set(Boost_USE_STATIC_RUNTIME ON) # 可选：如果想连C/C++运行时也静态链接

find_package(Boost COMPONENTS filesystem iostreams REQUIRED)

# 无需手动设置include/link目录，直接链接target即可
target_link_libraries(${PROJECT_NAME} PRIVATE Boost::filesystem Boost::iostreams)

Boost的Boost::xxx target已经包含了所有必要的include目录和库依赖，比手动用${Boost_LIBRARIES}靠谱得多，还能避免冗余的链接配置。

3. 彻底清理CMake缓存（必做！） #

之前你可能用动态库配置过项目，CMake缓存里残留的旧路径信息会导致Visual Studio依然去错误目录找库。你需要：

• 删除项目根目录下的CMakeCache.txt文件
• 删除out-of-source构建的build文件夹
• 重新运行上面的CMake命令生成项目

4. 验证Visual Studio配置（可选） #

打开生成的VS项目后，你可以检查确认配置是否正确：

• 右键项目 → 属性 → VC++目录 → 库目录，应该显示C:\vcpkg\installed\x64-windows-static\lib
• 链接器 → 输入 → 附加依赖项，应该是boost_filesystem-vc140-mt-s.lib这类带-s后缀的静态库（-s是静态库的标识）

如果这些都正确，再重新构建项目，应该就不会报找不到动态库的错误了。

另外，如果你想把所有依赖（包括MSVC运行时）都静态合并到最终EXE里，记得在CMake里加上：

set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")

这会强制使用静态版本的MSVC运行时，避免最终EXE依赖vcruntime140.dll这类系统文件。

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