UWP项目NuGet包下载失败、清缓存后构建报错如何解决?
UWP项目NuGet依赖下载异常、清缓存后构建报错解决
问题现象
- UWP项目开发过程中NuGet依赖包下载环节出现异常
- 执行NuGet缓存清理操作后,项目构建直接触发报错
- 切换多个有线、WiFi网络环境重试,问题始终无法解决
相关报错截图:

可直接落地的解决步骤
- 第一步先核对NuGet源配置
打开Visual Studio的「工具-NuGet包管理器-程序包管理器设置」,切到「包源」 tab,只保留官方nuget.org源(地址是https://api.nuget.org/v3/index.json),把其他第三方自定义源、失效的本地源全部取消勾选,保存后重试包还原。 - 手动彻底清理残留缓存
VS自带的缓存清理经常删不干净损坏的包文件,直接手动打开以下两个目录,把里面所有内容全删掉:C:\Users\<你的当前系统用户名>\.nuget\packagesC:\Users\<你的当前系统用户名>\AppData\Local\NuGet\v3-cache
删完完全关闭Visual Studio,重新打开项目再触发还原。
- 执行强制包重装
打开VS里的「程序包管理器控制台」,执行下面的命令强制把所有项目关联的NuGet包重新安装一遍,修复缓存清理导致的包引用丢失问题:
如果是命令行操作,切到项目根目录执行:Update-Package -reinstall -ProjectName <你的UWP项目名>msbuild /t:restore /p:RestoreForce=true - 校验项目SDK版本匹配
右键UWP项目打开「属性」页,检查项目配置的目标Windows版本、最低支持版本,和你本机已经安装的Windows SDK版本完全对应,版本不匹配会导致NuGet还原完适配版本的包也无法正常加载,直接报构建错误。 - 排查网络拦截
哪怕换了WiFi环境,如果系统开了全局代理、第三方安全软件/防火墙拦截了NuGet的请求,还是会出现包下载不完整的问题,临时关闭这类工具再重试还原即可。
注意:如果重试过程中还是出现单个包下载失败的提示,直接去
.nuget/packages路径下找到对应包名+版本号的文件夹手动删除,再单独触发该包的下载即可,不需要重复全量清理。
内容的提问来源于stack exchange,提问作者pavan kumar
相关产品推荐
相关产品推荐

