MSBuild编译netcoreapp3.1时自动选用错误.NET SDK致报错的原因咨询

为什么6.0.203、6.0.301共存时优先选择6.0.203 #

.NET SDK 版本选择并非单纯按版本号数字大小取最新，会先匹配当前启动的MSBuild/Visual Studio对应的功能带兼容范围：

• .NET SDK 版本号遵循主版本.次版本.功能带.补丁号规则，6.0.2xx、6.0.3xx属于完全独立的两个功能带，分别对应不同版本的Visual Studio：6.0.2xx适配Visual Studio 2019 16.11，6.0.3xx适配Visual Studio 2022 17.3。
• 你使用的是VS2019自带的MSBuild，启动时会自动排除不兼容的6.0.3xx功能带SDK，仅在支持的6.0.2xx范围内查找最高版本，因此会选中6.0.203，完全不会识别更高功能带的6.0.301。

MSBuild选择SDK版本的核心逻辑，以及版本偏移原因 #

MSBuild本身不硬绑定特定SDK版本，启动后会调用dotnet宿主的内置解析规则选SDK，优先级从高到低如下：

• 项目根目录或上级目录中global.json明确指定的SDK版本与回滚策略
• 当前运行的MSBuild所属Visual Studio版本支持的SDK功能带范围
• 兼容范围内已安装SDK的最高补丁版本

你遇到的跨版本加载问题，核心诱因是手动安装了未通过VS安装器部署的6.0.203 SDK：

• 正常编译的设备上，VS2019 16.11配套安装的最高兼容SDK为5.0.409，没有其他更高版本的兼容SDK，因此解析到5.0.409，该版本解析netcoreapp3.1目标框架时会正确匹配对应运行时宿主包，编译正常。
• 故障设备上，手动安装的6.0.203属于VS2019兼容范围，解析优先级高于已安装的5.0.409，因此被优先加载。而6.0系列SDK在解析低版本netcoreapp3.1目标框架时，默认优先查找自身版本对应的运行时包目录，且手动安装的独立SDK未携带完整的旧版运行时宿主包，最终触发找不到Microsoft.NETCore.App.Host.win-x64的报错。

• 方案1：在解决方案根目录新建global.json文件，强制指定使用5.0.409版本SDK，彻底避免版本解析漂移，配置内容如下：

{
  "sdk": {
    "version": "5.0.409",
    "rollForward": "Disable"
  }
}

• 方案2：卸载手动安装的6.0.203 SDK，所有.NET SDK统一通过对应版本的Visual Studio安装器部署，避免兼容范围匹配混乱。
• 方案3：如果需要保留6.0系列SDK，可以在MSBuild命令中添加参数显式指定SDK路径，追加参数为/p:NetCoreSdkRoot="C:\Program Files\dotnet\sdk\5.0.409\"即可强制使用指定版本编译。

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