C++ 第三方库管理工具 Vcpkg 安装与使用教程

1. 为什么要用 Vcpkg？

    在 C++ 开发中，使用第三方库可以极大地提高开发效率，避免重复造轮子。然而，传统的第三方库管理方式存在许多问题，尤其是在 Windows 平台下。Vcpkg 是微软推出的一个开源 C++ 库管理工具，旨在解决这些问题。

1.1 传统使用开源库的方法

1.1.1 编译工具

大多数开源库最初是为 Linux 系统设计的，使用 GNU 工具链（如 configure 和 make）进行编译。虽然许多库现在支持跨平台的 CMake，但在 Windows 下编译这些库仍然复杂且容易出错。

常见的编译方式包括：

• configure + make：需要 MSYS 或 Cygwin 等 Unix 环境。

• 自定义编译工具：如 OpenSSL 和 Boost，需要学习特定的编译命令。

• CMake：相对简单，但仍需手动配置。

• VC 工程文件：直接使用 Visual Studio 编译，但这类库较少。

1.1.2 编译类型

在 Windows 下，编译第三方库时需要考虑多种组合：

• Debug 或 Release。

• 动态库（DLL）或静态库（LIB）。

• MD（动态链接运行时）或 MT（静态链接运行时）。

• 32 位（x86）或 64 位（x64）。

这些组合使得编译和管理第三方库变得非常复杂。

1.1.3 工程目录设定

由于编译类型多样，开发者需要手动设置工程目录，确保项目能够正确链接库文件和头文件。

1.2 Vcpkg 的优点

Vcpkg 解决了上述问题，具有以下优点：

• 自动下载和编译开源库：无需手动下载和配置。

• 依赖关系自动处理：例如，编译 libcurl 时会自动下载并编译 zlib 和 openssl。

• 无缝集成 Visual Studio：自动配置库文件和头文件路径，无需手动设置。

• 跨平台支持：支持 x86、x64、ARM、UWP 等多种平台。

• 版本管理：支持库的版本管理和升级。

---

2. 获取 Vcpkg

2.1 下载 Vcpkg

Vcpkg 的源码托管在 GitHub 上，可以通过以下方式获取：

• *（1）使用 Git 克隆：

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

• 

• （2）或者直接下载 ZIP 文件：从 Vcpkg GitHub 页面下载并解压。

2.2 编译 Vcpkg

Vcpkg 使用 PowerShell 脚本进行编译，因此建议使用 PowerShell 而不是 CMD。

1. 打开 PowerShell，导航到 Vcpkg 目录：

cd E:\Vcpkg\vcpkg

2、运行编译脚本：

.\bootstrap-vcpkg.bat

编译完成后，会在当前目录下生成 vcpkg.exe 文件。

3. 使用 Vcpkg

3.1 查看支持的库列表

运行以下命令，查看 Vcpkg 支持的所有库：

.\vcpkg search

3.2 安装一个库

以安装 jsoncpp 为例：

.\vcpkg install jsoncpp

Vcpkg 会自动下载、编译并安装 jsoncpp，同时处理其依赖项。

指定编译架构

默认情况下，Vcpkg 会编译 x86 版本的库。如果需要编译其他架构的库，可以使用 triplet 参数。例如，编译 64 位版本的 jsoncpp：

.\vcpkg install jsoncpp:x64-windows

3.3 移除已安装的库

如果需要移除某个库，可以使用 remove 命令：

.\vcpkg remove jsoncpp

3.4 列出已安装的库

运行以下命令，查看已安装的库：

.\vcpkg list

3.5 更新库

Vcpkg 支持更新已安装的库：

• 查看可更新的库：

• .\vcpkg update

  更新所有库：

• .\vcpkg upgrade

  3.6 导出和导入库

• 导出库：

• .\vcpkg export jsoncpp --7zip

  导入库：

• .\vcpkg import jsoncpp.7z

  4. Vcpkg 与 Visual Studio 集成

  4.1 全局集成

  将 Vcpkg 集成到全局环境，适用于所有 Visual Studio 项目：

• .\vcpkg integrate install

  

• 集成后，Visual Studio 会自动识别 Vcpkg 安装的库，无需手动配置头文件和库路径。

  4.2 移除全局集成

  如果需要移除全局集成，运行以下命令：

• .\vcpkg integrate remove

  4.3 工程级集成

  如果不想全局集成，可以为单个项目配置 Vcpkg：

• 生成 NuGet 配置文件：

.\vcpkg integrate project

1. 在 Visual Studio 中，右键点击项目，选择“管理 NuGet 程序包”，添加 Vcpkg 的 NuGet 源。

4.4 集成到 CMake

如果使用 CMake，可以在 CMakeLists.txt 中添加以下配置：

set(CMAKE_TOOLCHAIN_FILE "E:/Vcpkg/vcpkg/scripts/buildsystems/vcpkg.cmake")

5. 注意事项

1. Visual Studio 版本：Vcpkg 仅支持 Visual Studio 2015 Update 3 及以上版本。

2. 静态库编译：默认情况下，Vcpkg 编译的是动态库。如果需要静态库，可以使用 x86-windows-static 或 x64-windows-static 架构。

3. 网络问题：Vcpkg 需要从 GitHub 下载库的源码，如果网络不稳定，可能会导致下载失败。最好是采用代理方式git 源码，或者可以尝试使用代理或手动下载源码。

6. 总结

   Vcpkg 是一个强大的 C++ 库管理工具，能够极大地简化第三方库的下载、编译和集成过程。通过本教程，我们可以快速掌握 Vcpkg 的安装和使用方法，并在项目中轻松引入第三方库。

   如果你在安装或使用过程中遇到问题，可以参考 Vcpkg 官方文档 或可以留言。希望这篇教程能帮助你更好地使用 Vcpkg，提升开发效率！