vcpkg 安装 使用技巧 (详细-建议收藏)

一、vcpkg 简介

vcpkg 是一个用于管理 C++库的开源工具，由微软推出。它可以帮助开发者轻松地获取、构建和安装大量的 C++开源库，解决了在不同平台上编译和管理第三方库的复杂性问题，尤其在 Windows 平台下优势明显。

二、vcpkg 的安装

（1）下载 vcpkg

从 vcpkg 的 GitHub 仓库（）下载最新版本的 vcpkg。你可以使用 Git 克隆仓库，命令如下：

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

也可以直接下载 ZIP 文件，然后解压到指定目录，例如`D:\vcpkg`。

（2）编译 vcpkg

在 Windows 系统中，建议使用 PowerShell 进行编译。打开 PowerShell，导航到 vcpkg 目录，例如：

```powershell
cd D:\vcpkg
```

然后运行编译脚本：

```powershell
.\bootstrap-vcpkg.bat
```

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

（3）配置环境变量（可选）

为了能够更方便地使用 vcpkg 命令，可以将 vcpkg 的安装目录添加到系统环境变量 Path 中。具体操作如下：

• 右键点击“此电脑”选择“属性”。

• 点击“高级系统设置”。

• 在“系统属性”窗口中，点击“环境变量”按钮。

• 在“系统变量”中，找到 Path 变量，点击“编辑”。

• 在变量值中添加 vcpkg 的安装路径，例如`D:\vcpkg\vcpkg\scripts`。

• 点击“确定”保存设置。

三、vcpkg 的使用技巧

（1）查看支持的库列表

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

```powershell
.\vcpkg search
```

或者

```powershell
vcpkg search
```

（如果已配置环境变量）

（2）安装库

以安装 jsoncpp 为例，运行以下命令：

```powershell
.\vcpkg install jsoncpp
```

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

```powershell
.\vcpkg install jsoncpp:x64-windows
```

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

（3）移除已安装的库

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

```powershell
.\vcpkg remove jsoncpp
```

（4）列出已安装的库

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

```powershell
.\vcpkg list
```

（5）更新库

• 查看可更新的库：

```powershell
.\vcpkg update
```

• 更新所有库：

```powershell
.\vcpkg upgrade
```

（6）导出和导入库

• 导出库：

```powershell
.\vcpkg export jsoncpp --7zip
```

• 导入库：

```powershell
.\vcpkg import jsoncpp.7z
```

（7）与 Visual Studio 集成

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

```powershell
.\vcpkg integrate install
```

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

• 移除全局集成：

```powershell
.\vcpkg integrate remove
```

（8）与 CMake 集成

• 在 CMake 项目中使用 vcpkg 管理的库，需要在 CMake 配置中添加 vcpkg 的工具链文件。假设你已经安装并配置了 vcpkg，可以在 CMake 中使用`-DCMAKE_TOOLCHAIN_FILE`参数来指定 vcpkg 的工具链文件：

```bash
cmake -DCMAKE_TOOLCHAIN_FILE=C:/path/to/vcpkg/scripts/buildsystems/vcpkg.cmake ..
```

• 在 CMakeLists.txt 文件中使用`find_package()`来查找并链接库。例如，如果你安装了 Boost：

```cmake
find_package(Boost REQUIRED)
target_link_libraries(my_target Boost::Boost)
```

四、注意事项

• 确保你的系统已经安装了必要的编译器和工具，例如在 Windows 上安装 Visual Studio 的 MSVC 编译器。

• 在使用 vcpkg 时，可能会遇到网络问题导致下载库失败。可以尝试使用国内的镜像源，例如配置阿里云镜像：

```powershell
.\vcpkg set source:https://mirrors.aliyun.com/vcpkg/source
```

• 如果在安装或使用过程中遇到问题，可以参考 vcpkg 的官方文档（）或社区论坛获取帮助。

通过以上步骤和技巧，你可以轻松地安装和使用 vcpkg 来管理 C++库，提高开发效率。