vcpkg可简化C++项目第三方库管理,支持多平台、自动依赖处理与CMake/VS集成;需克隆构建后配置环境变量,通过install命令安装库,用toolchain文件或integrate集成到项目。

在 C++ 项目中使用 vcpkg 可以大幅简化第三方库的安装与集成。它支持 Windows、Linux 和 macOS,能自动处理依赖、编译、版本控制和 Visual Studio / CMake 集成。
安装 vcpkg
从 GitHub 克隆源码并完成初始构建:
- 打开终端(Windows 推荐 PowerShell 或 CMD,Linux/macOS 用 bash/zsh)
- 运行:git clone https://github.com/Microsoft/vcpkg.git
- 进入目录:cd vcpkg
- 执行引导构建:./bootstrap-vcpkg.bat(Windows)或 ./bootstrap-vcpkg.sh(Linux/macOS)
完成后会生成可执行文件 vcpkg(Windows 下为 vcpkg.exe),建议将其所在路径加入系统环境变量,方便全局调用。
安装第三方库(如 fmt、jsoncpp、boost)
vcpkg 默认安装的是 x64-windows 三元组(triplet),你也可以指定平台和架构:
立即学习“C++免费学习笔记(深入)”;
95Shop可以免费下载使用,是一款仿醉品商城网店系统,内置SEO优化,具有模块丰富、管理简洁直观,操作易用等特点,系统功能完整,运行速度较快,采用ASP.NET(C#)技术开发,配合SQL Serve2000数据库存储数据,运行环境为微软ASP.NET 2.0。95Shop官方网站定期开发新功能和维护升级。可以放心使用! 安装运行方法 1、下载软件压缩包; 2、将下载的软件压缩包解压缩,得到we
- 安装默认 triplet:vcpkg install fmt jsoncpp
- 指定 triplet(例如静态链接的 32 位 Windows):vcpkg install boost-system:x86-windows-static
- 查看可用 triplet:vcpkg help triplet
- 搜索库:vcpkg search json
安装过程会自动下载源码、配置、编译并安装到 installed/ 目录下,同时生成 pkgconfig、CMake config 等元信息。
在 CMake 项目中集成 vcpkg
推荐方式是通过工具链文件(toolchain file)让 CMake 自动识别 vcpkg 安装的库:
- 创建 CMakeLists.txt(确保 CMake ≥ 3.10)
- 调用 CMake 时传入 toolchain:cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=[vcpkg-root]/scripts/buildsystems/vcpkg.cmake
- 在 CMakeLists.txt 中直接 find_package(fmt CONFIG REQUIRED) 即可使用
- 若使用 Visual Studio,可通过 vcpkg integrate install 注册到全局(需管理员权限),之后新建项目即可自动识别已安装库
常用管理命令
日常维护库版本和环境:
- 列出已安装包:vcpkg list
- 升级所有包(先更新 vcpkg 自身):git -C vcpkg pull && vcpkg update && vcpkg upgrade --no-dry-run
- 卸载某个库:vcpkg remove jsoncpp
- 导出为二进制(便于分发):vcpkg export zlib --7zip
- 清理未使用的构建缓存:vcpkg cache clear
vcpkg 不强制要求项目根目录包含 vcpkg,但建议将 vcpkg.json 文件放在项目中声明依赖,配合 vcpkg install --manifest 实现可重现的依赖管理。










