Windows安装vcpkg教程（VS2022）

内容摘要：

本文详细介绍如何在Windows系统上使用 Git 克隆 vcpkg 仓库来安装vcpkg工具，并链接Visual Studio 2022。

目录

一、关于vcpkg

二、开发环境

三、安装Git

四、使用 Git 克隆 vcpkg 仓库

---

一、关于vcpkg

vcpkg 是一个开源的 C++ 包管理工具，旨在简化 C++ 库的管理、安装和集成。它帮助开发者轻松地将第三方 C++ 库集成到自己的项目中，并提供了一种跨平台的方式来管理和分发 C++ 库。vcpkg 支持 Windows、Linux 和 macOS，能够自动处理库的下载、构建和依赖关系，极大地简化了 C++ 开发中的外部库管理问题。

vcpkg与其它管理工具的对比：

1. vcpkg vs Conan：

   • Conan 是另一个流行的 C++ 包管理工具，旨在简化 C++ 项目的依赖管理。Conan 提供更强大的跨平台支持，支持与多种构建系统（如 CMake、Visual Studio、Make 等）集成。
   • vcpkg 更注重与 Visual Studio 和 CMake 的无缝集成，并提供了更为简单的命令行界面和安装方式。
   • 差异：vcpkg 主要用于管理由 Microsoft 和其他开源社区提供的 C++ 库，并且通常支持 Windows 和 Linux/macOS 平台。而 Conan 支持更多的构建系统、版本和配置，可以为多种平台提供更多定制选项。

2. vcpkg vs 自行管理依赖： 在没有 vcpkg 的情况下，开发者需要手动下载、构建和集成外部库，管理所有的依赖关系。这不仅耗时，而且容易出错。vcpkg 提供了一个简单、高效的方式来自动处理这些任务，减少了人工错误的发生。

vcpkg的优点：

• 易用性：通过命令行一行命令安装、卸载库，简化了 C++ 项目中库的管理。
• 跨平台支持：支持 Windows、Linux 和 macOS，让同一个项目可以在多个平台上使用相同的依赖。
• 自动化依赖管理：自动处理库的构建和依赖关系，不需要手动解决版本和依赖冲突。
• 与 CMake 完美集成：通过 CMAKE_TOOLCHAIN_FILE 配置，vcpkg 能自动配置 CMake 项目，省去了手动配置路径的麻烦。

二、开发环境

1.操作系统：Win10/Win11

2.开发工具：Visual Studio 2022

3.开发语言：C/C++

4.Git版本：2.47.0.2

三、安装Git

在安装 vcpkg 之前，Git 是一个必要的工具，因为 vcpkg 是通过 Git 从 GitHub 仓库克隆下来的。Git 是一个分布式版本控制系统，允许你从远程仓库（例如 GitHub）下载源代码并管理版本。

1.下载地址： 

Git官方网址： http://git-scm.com（包含不同系统不同平台的安装包和源代码）

适用于Windows的Git下载网址：http://gitforwindows.org （只有 windows 系统的安装包）

2.安装步骤：

下载后双击exe进行安装，如下图所示。

点击next，笔者设置安装位置为D:\METIS\GIT。

根据自己的需要选择组件进行下载，默认如下图所示。

方框内 Git 为安装组件的文件夹名称，可改为其他名字，也可点击 “Browse...” 选择其他文件夹或者给"Don't create a Start Menu folder" 打勾不要文件夹。

后续一直点击next，选择默认设置即可，安装完成后点击finish。

3.配置环境：

安装好后将git.exe的路径添加到系统 path 环境变量当中去，这样就可以在Windows系统Win+R的系统cmd命令行中使用vcpkg。我们主要使用的是 Git CMD ，当添加完Gti环境变量后，你也就可以使用Windos系统自带的cmd命令行工具。

右键此电脑->属性->高级系统设置->环境变量，如下图所示。

在系统变量中双击Path，点击新建，将bin文件夹的地址填入，笔者地址为D:\METIS\GIT\Git\bin，点击确定。

其中D:\METIS\GIT为安装位置，Git为安装组件的文件夹名。

4.检测安装是否成功：

使用快捷键Win+R，输入cmd打开终端，输入以下命令：

git --version

如果 Git 已成功安装并且环境变量已正确配置，你应该看到类似以下的输出： 

 这表示你安装的 Git 版本（例如版本 2.47.1.windows.2）。如果你看到类似这样的版本号输出，说明 Git 已经成功安装并配置好环境变量。

四、使用 Git 克隆 vcpkg 仓库

1.下载地址：

• vcpkg 官方网站：https://vcpkg.io

这个网站提供了 vcpkg 的详细文档、安装指南、使用教程以及如何为 vcpkg 添加新的库等内容，可以在这个网站上找到关于 vcpkg 的所有资源。

• vcpkg GitHub 仓库：https://github.com/microsoft/vcpkg

vcpkg 的源代码和贡献指南都托管在 GitHub 上，在 GitHub 上可以找到 vcpkg 的源代码、发布历史以及其他开发者的贡献。（本文安装方法使用该网址）

2.准备工作：

新建空文件夹，建议使用短路径名称（不含空格）（如 C:\src\win32\ 或 C:\dev\iot\），笔者以D:\vcpkg为例。首先下载引导vcpkg，安装位置随意，但是为了之后方便与Visual Studio以及其他C/C++编译器链接，建议使用类似 C:\src 或者 C:\dev ，可以理解为在本地建立一个库的仓库，之后所有的安装都在该目录下，否则会由于路径的缘故会遇到某些端口构建系统的路径问题。

3.使用 Git 克隆 vcpkg 仓库：

打开Git CMD命令行工具，使用 cd 到建立的目标路径（本文以D:\vcpkg为例）

使用 Git 克隆 vcpkg 仓库，输入以下命令：

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

终端如下图所示。

 这将会把 vcpkg 仓库克隆到当前目录中，并创建一个 vcpkg 文件夹。vcpkg 的所有源代码和工具都会被下载到该文件夹中。

下载完成如下图所示。

再次使用 cd 命令到vcpkg文件路径内（本文以D:\vcpkg\vcpkg为例）

运行构建脚本来编译 vcpkg，输入以下命令：

 .\bootstrap-vcpkg.bat 

终端如下图所示。

 下载完成后会编译并生成 vcpkg.exe 工具。

4.配置环境：

为了方便在任何地方使用 vcpkg 命令，可以将 vcpkg 的路径添加到环境变量中，使其在命令行中全局可用。右键此电脑->属性->高级系统设置->环境变量，在系统变量中双击Path，点击新建，将bin文件夹的地址填入，笔者地址为D:\vcpkg\vcpkg，点击确定。

5.检测安装是否成功：

使用快捷键Win+R，输入cmd打开终端，输入以下命令：

vcpkg --version

如果vcpkg已成功安装并且环境变量已正确配置，你应该看到类似以下的输出： 

vcpkg package management program version 2024-11-12-eb492805e92a2c14a230f5c3deb3e89f6771c321

See LICENSE.txt for license information.

这表示 vcpkg 已成功安装并正确运行。输出的内容包括以下信息：

vcpkg版本号：

输出中的 2024-11-12-eb492805e92a2c14a230f5c3deb3e89f6771c321 部分是 vcpkg 的版本信息。版本号包含两个部分：

• 日期：2024-11-12 表示 vcpkg 的版本发布日期。
• 提交哈希：eb492805e92a2c14a230f5c3deb3e89f6771c321 是当前 vcpkg 版本的 Git 提交哈希（唯一标识）。

这意味着安装的 vcpkg 是一个特定日期和版本的构建。

LICENSE.txt 提示：

See LICENSE.txt for license information 表示你可以查看 vcpkg 项目的 LICENSE.txt 文件，了解 vcpkg 的许可协议。

6.链接Visual Studio 2022：

继续在Git CMD的D:\vcpkg\vcpkg地址下输入以下命令：

 .\vcpkg integrate install

运行结果如下，即链接成功。

欢迎交流🌹🌹

---

参考资料：

Git 详细安装教程（详解 Git 安装过程的每一个步骤）_git安装-优快云博客

Vcpkg C/C++库管理工具安装和使用教程（链接VS2019）_vcpkg 安装-优快云博客