新建ASP.NET Core MVC项目Visual Studio编译失败且NuGet无法安装

一、修复Visual Studio组件与.NET SDK #

• 打开Visual Studio Installer，点击「修改」，进入「单个组件」页面，确认勾选项目对应版本的.NET SDK，以及「ASP.NET和Web开发」工作负载下的全部必要组件，点击「修改」完成重新安装。
• 打开命令提示符，运行dotnet --list-sdks查看已安装的SDK版本，若缺失项目所需版本，直接从微软官网下载对应SDK手动安装。
• 进入项目根目录，依次运行dotnet clean和dotnet restore，清理编译缓存并重新还原项目依赖。

二、重置NuGet配置与缓存 #

• 关闭Visual Studio，以管理员身份打开命令提示符，执行nuget locals all -clear清空所有NuGet本地缓存。
• 重启Visual Studio，进入「工具」→「选项」→「NuGet包管理器」→「包源」，移除无效或自定义的包源，仅保留「nuget.org」官方源，点击「更新」保存配置。
• 若仍无法安装NuGet包，可手动下载对应版本的.nupkg文件，放到本地自定义包源目录，再从本地源选择安装。

三、修复Visual Studio安装 #

• 打开Visual Studio Installer，点击「更多」→「修复」，执行完整修复流程，期间不要中断操作。
• 修复完成后重启电脑，创建新的ASP.NET Core MVC项目测试编译与NuGet功能。

四、排查系统权限与网络拦截问题 #

• 右键Visual Studio图标，选择「以管理员身份运行」，避免因权限不足导致的文件写入或网络请求失败。
• 临时关闭系统防火墙、杀毒软件，测试是否能正常安装NuGet包，若恢复正常，需将Visual Studio和NuGet加入信任列表。
• 检查项目是否存放在系统受保护目录（如C:\Program Files），将项目移到用户个人目录（如「文档」文件夹）后重新测试。

五、彻底清理残留（针对复发场景） #

• 卸载Visual Studio后，手动删除以下目录：
  • C:\Program Files (x86)\Microsoft Visual Studio
  • C:\Program Files\dotnet（无需保留其他.NET版本时）
  • %USERPROFILE%\.nuget\packages
  • %USERPROFILE%\AppData\Local\Microsoft\VisualStudio
• 打开注册表编辑器，删除HKEY_CURRENT_USER\Software\Microsoft\VisualStudio和HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio下对应VS版本的键值（操作前建议备份注册表）。
• 重启电脑后重新安装Visual Studio，选择默认工作负载并勾选所需的.NET SDK版本。

内容的提问来源于stack exchange，提问作者DireRaven