vcpkg是微软推出的跨平台c++包管理工具,支持windows、linux和macOS,通过git克隆后运行引导脚本安装,使用search和install命令查找与安装第三方库,如fmt、spdlog等,默认静态编译,可通过triplet指定动态或静态链接;集成到CMake项目时,在cmake命令中指定DCMAKE_TOOLCHaiN_FILE指向vcpkg.cmake文件,即可在CMakeLists.txt中用find_package引入库;推荐项目级集成以保持环境隔离,避免全局冲突。

在C++开发中,管理第三方库一直是个痛点。vcpkg 是微软推出的跨平台C++包管理工具,支持 Windows、Linux 和 macOS,能帮你轻松安装和管理开源库。下面介绍如何配置与使用 vcpkg 来管理项目依赖。
安装 vcpkg
vcpkg 本身是一个开源项目,你可以通过 Git 克隆并构建它:
- 打开终端或命令行,执行:git clone https://github.com/microsoft/vcpkg.git
- 进入目录:cd vcpkg
- 运行引导脚本:
– Windows: .bootstrap-vcpkg.bat
– Linux/macos: ./bootstrap-vcpkg.sh
完成后你会得到一个可执行的 vcpkg 命令行工具。
搜索与安装第三方库
使用 vcpkg 安装库非常简单。例如要安装 fmt 库(现代C++格式化库):
立即学习“C++免费学习笔记(深入)”;
- 搜索库:./vcpkg search fmt
- 安装库:./vcpkg install fmt
你也可以一次性安装多个库,比如:./vcpkg install spdlog fmt jsoncpp
默认情况下,vcpkg 会为当前平台静态编译库。如需动态链接,可指定 triplet:
./vcpkg install fmt –triplet=x64-windows(动态)
./vcpkg install fmt –triplet=x64-windows-Static(静态)
集成到 CMake 项目
大多数现代C++项目使用 CMake,vcpkg 提供了对 CMake 的无缝支持。
方法一:在 cmake 命令中指定 toolchain 文件:
cmake .. -DCMAKE_TOOLCHAIN_FILE=[vcpkg根目录]/scripts/buildsystems/vcpkg.cmake
例如:
cmake .. -DCMAKE_TOOLCHAIN_FILE=../vcpkg/scripts/buildsystems/vcpkg.cmake
CMake 会自动找到已安装的库,你可以在 CMakeLists.txt 中直接使用 find_package:
find_package(fmt REQUIRED) target_link_libraries(your_target PRIVATE fmt::fmt)
全局或项目级集成(可选)
如果你不想每次 cmake 都传 toolchain 参数,可以:
- 全局集成(不推荐多项目混用时):
执行:./vcpkg integrate install
这会让 visual studio 或 CMake 自动识别 vcpkg 库。 - 项目级集成(推荐):
将 toolchain 路径写入项目的 CMakePresets.json 或 CI 脚本中,保持环境隔离。
基本上就这些。vcpkg 极大简化了C++依赖管理,尤其适合跨平台项目。只要记得统一 triplet 和链接方式(静态/动态),就能避免多数兼容问题。