vcpkg是C++ 世界的 依赖管理工具，可以自动下载源码 + 编译 + 配置第三方库

默认已经安装配置完Git

vcpkg

下载

克隆vcpkg的源代码：

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

这里失败多是网络原因 调试代理即可 实在不行用github desktop下载

构建

clone后，cd进入vcpkg目录，运行：

.\bootstrap-vcpkg.bat

全局安装

.\vcpkg integrate install

此命令会将vcpkg的路径添加到VS的环境变量，从而能够自动配置第三方库。

此时vcpkg会自动为我们进行相关库的引用和链接，我们要做的就是直接#include引入并使用相关的第三方库即可。

配置库

.\vcpkg install [库名称]

自动安装库，如果已经将vcpkg集成至VS，那么VS会自动检测到已安装的库。

如果自动集成没有成功，在VS中检测不到安装的库，那么就需要手动配置设置：

1. C/C+±常规-附加包含目录：添加vcpkg下载的包目录的include路径
2. 链接器-常规-附加库目录：添加vcpkg下载的包目录的lib路径
3. 链接器-输入-附加依赖项：添加需要的库文件

删除已下载的库用remove即可 但要如果该包被其他包依赖，需要注意依赖问题。

Visual Studio 部分

Visual Studio，创建一个新项目，右键项目打开项目属性可以看到已经多了一个vcpkg选项

如果我们要使用静态库还需要对vcpkg进行一个设置，打开上文展示的vcpkg选项卡，找到使用静态库(Use Static Libraries)，勾选Yes即可

常见问题

vcpkg 构建 [库名称] 失败

e.g：

error: building hiredis:x64-windows failed with: BUILD_FAILED

可以尝试在 powershell或Visual Studio 开发者命令行(Developer Command Prompt for VS 2022) 在管理员模式下运行，然后重新安装库

可能的原因：

1 Visual Studio 工具链配置不全

解决方案：

• 打开 Visual Studio Installer

• 点击 “修改” → 确保勾选以下：

  • ✅ 使用 C++ 的桌面开发（Desktop development with C++）

  • ✅ MSVC v143 或 v142 编译工具

  • ✅ Windows 10/11 SD

  • ✅ CMake tools for Windows

  • ✅ Ninja

2 vcpkg 版本老旧或者代理配置错误

git pull然后update一下 一般不太会是这个问题

3 确认没有路径包含中文或特殊符号！

如果你的系统用户名或临时文件路径（如 %TEMP%）中有中文，会引发类似错误。

我就是临时文件路径有中文 更改后就ok了

检查临时路径：

echo %TEMP%

如果是类似：

C:\Users\中文用户名\AppData\Local\Temp

建议临时更改：

set TEMP=D:\Temp set TMP=D:\Temp

然后重新运行 vcpkg install ...

尝试清理并重建 vcpkg 构建缓存