如何在Windows上编译和使用c++的Boost库？ (b2编译指南)

2026-01-12

如何在Windows上编译和使用c++的Boost库？ (b2编译指南)

必须用b2而非CMake编译Boost，因其官方构建系统为自研b2，CMake无法正确处理变体、ABI标签、隐式依赖及条件编译，易致链接错误或崩溃；b2生成的库名自带编译器、线程模型等标识，且能自动管理依赖。

如何在windows上编译和使用c++的boost库？ (b2编译指南)

为什么要用 `b2` 而不是 `cmake` 编译 Boost？

Boost 官方不提供 CMakeLists.txt，它的构建系统是自研的 b2（原名 bjam），所有官方文档、测试和发行版都基于它。强行用 CMake 包装 Boost 构建，容易漏掉变体（如 threading=multi）、ABI 标签（如 vc143）或静态/动态链接控制，最终导致 LNK2001 或运行时崩溃。

b2 生成的库文件名自带标识，比如 libboost_filesystem-vc143-mt-x64-1_85.lib，一眼可知编译器、线程模型、架构和版本
它能自动处理 Boost 内部依赖（如 boost_system 是 boost_filesystem 的隐式依赖），CMake 手动写 target_link_libraries 容易漏
Windows 上部分库（如 boost_stacktrace_windbg）只在 b2 下触发条件编译，CMake 无法启用

下载后第一步：运行 `bootstrap.bat` 生成 `b2.exe`

别跳过这步——直接双击或命令行执行 bootstrap.bat 才能生成 Windows 原生的 b2.exe。它会探测当前 Visual Studio 工具链（如 vc143 对应 VS 2022），并把编译器路径写进 project-config.jam。

如果提示 “Failed to build Boost.Build engine”，说明没装对应版本的 Visual Studio Build Tools，或环境变量 VSINSTALLDIR 没设对
若机器上装了多个 VS（如 VS 2019 和 VS 2022），bootstrap.bat 默认选最新版；要指定旧版，可先运行：
```
call "C:/Program Files/Microsoft Visual Studio/2019/Community/VC/Auxiliary/Build/vcvars64.bat"
```
，再运行 bootstrap.bat
生成的 b2.exe 默认放在 Boost 根目录，不用手动加到 PATH，后续命令直接调用即可

关键编译参数：控制 ABI、链接方式和线程模型

Boost 库名里每个字段都由 b2 参数决定，写错一个就可能链接失败。最常出问题的是 link、runtime-link 和 threading。

OpenMP并行程序设计 WORD版

本文档主要讲述的是OpenMP并行程序设计；OpenMP是一个编译器指令和库函数的集合，主要是为共享式存储计算机上的并行程序设计使用的。目前支持OpenMP的语言主要有Fortran，C/C++。 OpenMP在并行执行程序时，采用的是fork/join式并行模式，共享存储式并行程序就是使用fork/join式并行的。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看

下载

link=static：生成 .lib，代码全打进去；link=shared：生成 .dll + .lib（导入库），运行时要带 DLL
runtime-link=static：静态链接 libcmt.lib（多线程静态 CRT）；runtime-link=shared：动态链接 msvcp140.dll（默认，但要求目标机器装 VC++ 运行库）
threading=multi：启用线程安全（几乎所有 Boost 库都需要）；threading=single 仅用于极简嵌入场景，多数库会禁用

完整常用命令示例（VS 2022 x64，静态链接 CRT，多线程，生成 .lib）：

b2 -a -j12 --build-type=complete --stagedir=stage vc143 link=static runtime-link=static threading=multi stage

在自己的 C++ 项目中正确链接 Boost

不是把 stage/lib 加进库目录就完事——必须确保你项目使用的编译选项和 Boost 库完全一致，否则即使头文件能找到，链接器也会报 unresolved external symbol。

立即学习“C++免费学习笔记（深入）”；

检查你的项目属性 → C/C++ → Code Generation → Runtime Library：若 Boost 是 runtime-link=static，这里必须选 /MT（不是 /MD）
Linker → General → Additional Library Directories：填 boost_root/stage/lib
Linker → Input → Additional Dependencies：显式写全名，比如 libboost_filesystem-vc143-mt-s-x64-1_85.lib（注意 -mt-s- 表示 multi-threaded + static CRT）
别依赖 #pragma comment(lib, "...") 自动链接：它无法区分不同 ABI 变体，容易拉错库
若用 MSVC 的 /clr 或 /ZW，Boost 部分库（如 boost_python）需额外加 define=BOOST_PYTHON_STATIC_LIB，否则导出符号不匹配

Boost 的 ABI 敏感性远超一般第三方库，vc143 和 vc142 编译的库不能混用，/MT 和 /MD 也不能混用。哪怕只是升级了 VS 小版本（如从 17.6 到 17.7），也建议重新跑一遍 b2 编译，别复用旧的 .lib。

https://www.php.cn/faq/1968479.html