vcpkg是微软开发的C/C++库管理工具，支持跨平台自动下载、编译和集成开源库。通过git克隆并运行引导脚本生成可执行文件后，可用search和install命令查找安装依赖，如boost、fmt等，默认静态链接，支持动态库指定后缀。集成到CMake项目时，通过-DCMAKE_TOOLCHAIN_FILE引入toolchain文件，CMake自动处理路径，配合find_package和target_link_libraries使用。推荐在项目根目录创建.vcpkg-root标记和vcpkg.json声明依赖，实现团队与CI环境一致性，结合CMake Presets统一构建配置，使C++依赖管理高效便捷。
在C++开发中，手动管理第三方库常常耗时且容易出错。vcpkg 是由微软开发并维护的跨平台 C/C++ 库管理工具，支持 Windows、Linux 和 macOS，能自动下载、编译和集成开源库，极大简化依赖管理流程。
安装 vcpkg
vcpkg 本身是一个开源项目，你可以通过 Git 克隆并构建它：
- 打开终端或命令行，执行以下命令： git clone https://github.com/microsoft/vcpkg.git
- 进入 vcpkg 目录并运行引导脚本： cd vpkpg && ./bootstrap-vcpkg.sh（Linux/macOS）
- 完成后会生成 vcpkg 可执行文件，可用于后续操作。
.\bootstrap-vcpkg.bat（Windows）
搜索与安装库
使用 vcpkg 安装库非常简单。例如，你想使用 Boost 或 OpenCV：
- 先搜索可用的库： ./vcpkg search boost
- 安装指定库（如 boost-system）： ./vcpkg install boost-system
- 支持同时安装多个库： ./vcpkg install fmt spdlog openssl
- 默认安装的是静态库，若需动态链接库，可加上后缀： ./vcpkg install sqlite3:x64-windows-dynamic
集成到 CMake 工程
大多数现代 C++ 项目使用 CMake，vcpkg 提供了对 CMake 的无缝支持。
立即学习“C++免费学习笔记（深入）”；
- 在项目根目录的 CMakeLists.txt 同级位置创建一个 main.cpp 测试文件，并编写使用某个库的代码（如 fmt）。
- 配置 CMake 构建时，通过 -DCMAKE_TOOLCHAIN_FILE 指定 vcpkg 的 toolchain 文件： cmake . -B build -DCMAKE_TOOLCHAIN_FILE=vcpkg/scripts/buildsystems/vcpkg.cmake
- CMake 会自动找到已安装的库，无需手动设置 include 和 link 路径。
- 在 CMakeLists.txt 中正常 find_package 即可： find_package(fmt REQUIRED)
target_link_libraries(your_target PRIVATE fmt::fmt)
项目本地集成（推荐做法）
为确保团队成员和 CI 环境使用相同依赖，建议将 vcpkg 集成到项目中。
- 在项目根目录下创建 .vcpkg-root 文件（空文件即可），标记此目录为 vcpkg 项目根。
- 创建 vcpkg.json 文件声明依赖： {
- 运行 ./vcpkg install 会根据 vcpkg.json 自动安装所需库。
- 配合 CMake Presets 使用更佳，可统一构建配置。
"name": "my-project",
"version": "1.0.0",
"dependencies": [
"fmt",
"spdlog"
]
}
基本上就这些。vcpkg 让 C++ 的依赖管理变得像 npm 或 pip 一样直观。只要配置一次 toolchain，后续添加库只需 install + find_package，跨平台兼容性也由 vcpkg 自动处理。不复杂但容易忽略的是集成路径和 target 名称的写法，查官方 ports 文档最稳妥。基本上用熟了就离不开了。
