vcpkg管理C++依赖核心三步:安装vcpkg、集成到项目、安装并链接库;它跨平台、不依赖编译器版本、不强制改项目结构,支持VS、CMake和Makefile。

用 vcpkg 管理 C++ 依赖,核心就三步:安装 vcpkg、集成到项目、安装并链接库。它不依赖编译器版本,也不强制改项目结构,适合 VS、CMake、甚至 Makefile 项目。
安装 vcpkg 并完成基本配置
vcpkg 是一个开源的 C++ 包管理器,由微软维护,跨平台(Windows/macOS/Linux)。下载后只需简单构建即可使用:
- 克隆仓库:git clone https://github.com/Microsoft/vcpkg
- 进入目录并引导构建:cd vcpkg && ./bootstrap-vcpkg.bat(Windows)或 ./bootstrap-vcpkg.sh(macOS/Linux)
- 推荐执行全局集成(让 IDE 自动识别):vcpkg integrate install(需管理员/Root 权限)
这一步会让 Visual Studio 自动找到头文件和库,CMake 也能通过工具链文件自动加载依赖。
在 CMake 项目中使用 vcpkg
这是最常见也最推荐的方式。关键在于告诉 CMake 去哪找 vcpkg 提供的库:
立即学习“C++免费学习笔记(深入)”;
- 在 cmake 命令中加入工具链路径,例如:
cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=/path/to/vcpkg/scripts/buildsystems/vcpkg.cmake - 在 CMakeLists.txt 中用 find_package 查找库,比如:
find_package(fmt CONFIG REQUIRED) → 安装后可直接 #include - 无需手动写 include_directories 或 target_link_libraries,vcpkg 会自动处理接口属性
安装和切换常用库与 triplet
vcpkg 支持不同平台、架构、链接方式(静态/动态)的组合,叫 triplet。默认是 x64-windows(Windows)、x64-osx(macOS)、x64-linux(Linux):
- 安装库:vcpkg install openssl zlib spdlog:x64-windows-static
- 查看已安装包:vcpkg list
- 卸载:vcpkg remove fmt --recurse(加 --recurse 可删依赖项)
- 指定 triplet 安装(如静态链接):vcpkg install opencv[contrib]:x64-windows-static
注意:不同 triplet 的库互不兼容,CMake 工具链必须匹配安装时用的 triplet。
配合 Visual Studio 使用(零配置)
运行过 vcpkg integrate install 后,VS 2019/2022 新建的 CMake 项目会自动识别 vcpkg 库。普通 Win32 项目也可手动启用:
- 右键项目 → “属性” → “常规” → “vcpkg” → 勾选“启用 vcpkg 集成”
- 然后在“引用”里点“添加引用”,就能看到已安装的库(如 zlib、jsoncpp)
- 代码里直接 #include,无需额外设置包含路径或库目录
对大多数 Windows 开发者来说,这是最快上手的方式。











