You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

UWP项目NuGet包下载失败、清缓存后构建报错如何解决?

UWP项目NuGet依赖下载异常、清缓存后构建报错解决

问题现象

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

相关报错截图:
NuGet下载异常报错截图
构建阶段报错截图

可直接落地的解决步骤

  • 第一步先核对NuGet源配置
    打开Visual Studio的「工具-NuGet包管理器-程序包管理器设置」,切到「包源」 tab,只保留官方nuget.org源(地址是https://api.nuget.org/v3/index.json),把其他第三方自定义源、失效的本地源全部取消勾选,保存后重试包还原。
  • 手动彻底清理残留缓存
    VS自带的缓存清理经常删不干净损坏的包文件,直接手动打开以下两个目录,把里面所有内容全删掉:
    • C:\Users\<你的当前系统用户名>\.nuget\packages
    • C:\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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.26 10:54:15