“vcpkg install”失败问题记录

用到一些开源库时,想通过源码编译出来还真挺费劲的。但是通过vcpkg工具,可以很方便地获取到编译好的库。vcpkg 安装指定库的基本命令为 vcpkg install(可以通过vcpkg help install命令查看相关说明)。

实践中,遇到如下几种安装失败的情况。

网络原因导致的失败

安装某个包时,vcpkg会给出一个下载计划,其中列出了目标包及其所依赖的其它包。然后逐个下载、提取(解压)、编译、安装。

由于网络原因,导致下载过程很容易失败。此时,可以根据输出确定到下载失败的包。手动下载后,将其复制到vcpkg安装目录下的downloads子目录(vcpkg会先搜索这里)。直接将手动下载的包复制过去可能不行。需要观察命令行输出中下载该包时指定的名称是否与手动下载的压缩包名称一致。如果不一致,则需要根据命令行内容进行修改。

重新执行安装命令,vcpkg会自动检测已下载的包,并继续下载剩余包,直到目标包安装成功。

下图是vcpkg install fmt执行过程,因为之前安装过,所以没有"Downloading..."过程。

更新vcpkg导致的失败

某天安装包时,先搜索了一下目标包,发现版本比另一台电脑上的版本低。于是,更新了vcpkg。但是,后续安装目标包时报错,如下图所示。

这是因为vcpkg.exe还是旧的。进入vcpkg目录,重新执行.\bootstrap-vcpkg.bat后,问题解决。

PowerShell版本导致的失败

某天安装包时突然提示"A suitable version of powershell-core was not found (required v7.2.24)"。之所以说"突然",是因为我在另一台电脑上安装同一个包没有问题。我一直以为是我哪里误操作导致的,直到我更新了另一台电脑的vcpkg版本后出现了同样的提示。

虽然vcpkg会自动下载新的PowerShell,但是因为网络原因,我没有成功。改用winget工具后成功下载:

下载后的PowerShell位置为"C:\Program Files\PowerShell\7"。打开pwsh.exe,重新执行vcpkg安装命令即可。

注:PowerShell 7真好用啊。

参考资料

  1. 使用vcpkg安装库失败的解决方法

  2. 使用vcpkg安装c++库时出现git网络连接报错和找不到合适的powershell-core的解决方案_a suitable version of powershell-core was not foun

  3. 如何更新Windows自带的PowerShell至最新? - 知乎

  4. 在 Windows 上安装 PowerShell - PowerShell | Microsoft Learn (推荐)

相关推荐
敷啊敷衍6 分钟前
深入浅出 C++ 核心基础:从语法特性到入门体系构建
开发语言·c++
三体世界15 分钟前
Linux 动、静态库的实现
linux·开发语言·数据结构·c++·windows·算法
脏脏a1 小时前
C++入门篇(下)
c++
CodeSheep1 小时前
JetBrains再出手,最新IntelliJ IDEA 2025.1正式登场!
前端·后端·github
今麦郎xdu_1 小时前
【数据结构】红黑树
数据结构·c++·算法·stl
思麟呀1 小时前
list的模拟实现和反向迭代器的底层
c语言·数据结构·c++·list
不爱学英文的码字机器1 小时前
操作系统是如何运行的?
服务器·c语言·c++
七月丶1 小时前
🚀 从 Git 操作痛点出发,我为什么开发了 gix?
前端·后端·github
知其然亦知其所以然1 小时前
大模型时代,Java开发者别落伍!LangChain4j让你轻松追上
java·人工智能·后端