安装.NET MAUI workload后运行项目NuGet包恢复失败，遇NU1301错误

云上老周

2026-7-22

解决.NET MAUI项目NuGet还原失败（NU1301）问题

针对你遇到的NuGet包还原失败、NU1301错误以及依赖包无法被检测的问题，可以尝试以下步骤解决：

检查网络与NuGet源可用性
直接在浏览器打开https://api.nuget.org/v3/index.json，确认能正常加载JSON内容。如果无法访问，排查网络问题：关闭VPN/代理，或检查防火墙是否拦截了NuGet的请求。若使用公司代理，在Visual Studio的「工具」→「选项」→「NuGet包管理器」→「包源」中配置正确的代理地址和端口。
重置NuGet本地缓存
打开PowerShell或CMD，执行命令清理缓存：
```
nuget locals all -clear
```
完成后回到Visual Studio，右键项目选择「还原NuGet包」重新尝试。
检查NuGet配置文件
找到本地NuGet配置文件：C:\Users\MBAH SAMUEL\AppData\Roaming\NuGet\NuGet.Config，用记事本打开后确认nuget.org源配置正确：
```
<packageSources>
  <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
</packageSources>
```
删除无效或错误的源配置，保存后再尝试还原。
验证Visual Studio的NuGet组件
打开Visual Studio Installer，选择当前VS版本点击「修改」，在「单个组件」中搜索「NuGet」，确保「NuGet包管理器」和「.NET NuGet工具」已安装，未安装则勾选后完成更新。
核对项目包引用与版本
右键项目选择「编辑项目文件」，检查<PackageReference>节点的包版本是否与你安装的.NET MAUI workload版本匹配，比如：
```
<PackageReference Include="Microsoft.Maui.Controls" Version="7.0.92" />
<PackageReference Include="Microsoft.Maui.Controls.Compatibility" Version="7.0.92" />
```
若版本不兼容，修改为对应版本后重新还原。