VS 2019 16.8.3下创建.NET 5.0 Web应用报MSB3644错误求助

报错核心根因 #

该错误本质为MSBuild编译时无法定位与项目指定目标框架匹配的Targeting Pack/SDK组件。从VS16.6升级到16.8.3的过程中，若原有框架组件的路径关联被重置、或之前单独安装的.NET 5组件仅包含运行时未携带完整开发包文件，即便执行过VS修复操作，残留的配置错配依然会持续触发报错；报错关联的Microsoft.Common.CurrentVersion.targets为通用编译规则文件，并非该文件本身损坏引发问题。

分场景排查解决步骤 #

• 核查项目目标框架与已装组件的匹配性
  右键报错项目WebApplication2，选择「编辑项目文件」，定位<TargetFramework>节点的实际取值：
  • 若取值为net5.0：需确认当前系统安装的.NET 5组件为完整SDK版本，而非仅部署了运行时。单独安装的运行时不包含编译所需的Targeting Pack文件，会直接触发该报错；安装带完整开发组件的.NET 5 SDK后，重启VS重新加载项目即可识别。
  • 若取值为传统.NET Framework版本（如net48、net472等）：无需零散下载单独的Developer Pack安装文件，直接打开Visual Studio Installer，对应当前Enterprise版本VS实例选择「修改」，切换到「单个组件」标签，搜索报错提示对应版本的.NET Framework Targeting Pack选项，勾选后完成组件安装并重启VS即可。
• 修复VS对已安装.NET 5 SDK的路径识别
  部分场景下用户已安装完整.NET 5 SDK，但VS16.8.3升级后默认路径关联失效，导致MSBuild找不到SDK位置：
  打开VS的「工具-选项-项目和解决方案-.NET Core」设置页，确认勾选「使用.NET Core SDK的扩展预览版本」，若页面中SDK路径识别为空，手动将路径指向系统默认SDK安装目录C:\Program Files\dotnet\sdk，保存设置后重启VS。
• 清除残留构建缓存消除干扰
  升级过程中残留的旧版MSBuild缓存、项目本地构建文件会持续触发错配，即便执行VS修复也不会自动清除这类缓存：
  关闭所有VS实例，手动删除两类缓存文件后重启VS：
  • 报错项目根目录下的bin、obj文件夹
  • 用户本地应用目录下的VS组件缓存：路径为%LocalAppData%\Microsoft\VisualStudio\16.8_*\ComponentModelCache
• 临时规避方案
  若暂不具备补装组件的条件，可直接重定向项目目标框架：右键项目选择「属性-应用程序-目标框架」，在下拉列表中选择当前系统已安装对应Targeting Pack的框架版本，保存配置后重新编译即可绕过报错。

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