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）
.\bootstrap-vcpkg.bat（Windows）
• 完成后会生成 vcpkg 可执行文件，可用于后续操作。

搜索与安装库

使用 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 的无缝支持。

直播间话术巡检-windows

直播话术巡检系统(Windows版) — 实时语音转写、关键词检测、场景自动切换、告警推送、大屏可视化。支持 Windows VB-Cable 虚拟声卡音频采集，阿里云 ASR 实时识别。一键启动脚本，自动安装环境。

下载

立即学习“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 文件声明依赖：
{
  "name": "my-project",
  "version": "1.0.0",
  "dependencies": [
    "fmt",
    "spdlog"
  ]
}
• 运行 ./vcpkg install 会根据 vcpkg.json 自动安装所需库。
• 配合 CMake Presets 使用更佳，可统一构建配置。

基本上就这些。vcpkg 让 C++ 的依赖管理变得像 npm 或 pip 一样直观。只要配置一次 toolchain，后续添加库只需 install + find_package，跨平台兼容性也由 vcpkg 自动处理。不复杂但容易忽略的是集成路径和 target 名称的写法，查官方 ports 文档最稳妥。基本上用熟了就离不开了。