vcpkg C++ 包管理器完整指南

欢迎阅读这份关于 vcpkg 的详细指南——这是微软开发的一款跨平台 C++ 包管理器。本文面向所有级别的开发者，从新手到资深专家，帮助你从基础到高级技巧全面掌握 vcpkg。

1. 什么是 vcpkg？为什么需要它？

vcpkg 是一个开源命令行工具，它能极大地简化 C++ 项目中第三方库的管理流程。如果你曾经手动下载、编译并配置过 Boost、OpenCV 或 SQLite 这类库，你一定知道这个过程有多繁琐且容易出错。vcpkg 通过自动化整个流程解决了这个问题：从下载源代码、针对你的系统进行编译，到与你的开发环境（Visual Studio、CLion、VS Code 等）集成，一气呵成。

vcpkg 的核心目标是让开发者摆脱“依赖地狱”。与其花几个小时寻找正确的库版本、解决冲突、配置头文件和库路径，你只需输入一条命令：vcpkg install [包名]。vcpkg 会自动下载、编译并安装该库及其所有依赖项。这让开发过程更快速、更可靠，并且在不同机器上可重复。

vcpkg 的主要优势：

• 跨平台：支持 Windows、Linux 和 macOS。
• CMake 集成：vcpkg 提供 .cmake 文件，能自动找到已安装的库，让 CMake 项目的集成变得轻而易举。
• 版本管理：你可以在项目中锁定库的版本，确保构建的稳定性。
• 丰富的库目录：数千个可直接使用的库，从流行库到小众库一应俱全。
• 多配置支持：轻松在 Debug/Release、静态链接和动态链接之间切换。

2. 安装 vcpkg

安装 vcpkg 不需要使用 pip、npm 或 cargo。它是一个独立的工具，直接从 GitHub 仓库克隆即可。

步骤 1：克隆仓库

打开终端（或命令行）并执行以下命令：

git clone https://github.com/microsoft/vcpkg.git

步骤 2：运行引导脚本

进入 vcpkg 文件夹，根据你的操作系统运行相应的脚本：

Windows（PowerShell）：

cd vcpkg
.\bootstrap-vcpkg.bat

Linux / macOS：

cd vcpkg
./bootstrap-vcpkg.sh

完成后，你会在 vcpkg 文件夹中得到一个名为 vcpkg 的可执行文件。

步骤 3：（可选）添加到 PATH

为了方便从任何目录使用，请将 vcpkg 文件夹的路径添加到系统的 PATH 环境变量中。

3. 快速上手：一个最小工作示例

让我们安装 fmtlib（一个字符串格式化库）并在一个简单项目中使用它。

步骤 1：安装库

vcpkg install fmt

步骤 2：创建 CMake 项目

在同一个文件夹中创建 CMakeLists.txt 和 main.cpp 文件。

CMakeLists.txt：

cmake_minimum_required(VERSION 3.10)
project(HelloVcpkg)

# 查找并集成 vcpkg
# 该文件由 vcpkg 自动创建，并会自动