dotnet CLI提示找不到Microsoft.NET.Sdk系列SDK，构建及新建项目失败求助

问题情况 #

我的Blazor Server应用在Visual Studio 2022里能正常运行，但用dotnet CLI执行dotnet build命令构建时，弹出以下错误：

error MSB4236: The SDK 'Microsoft.NET.Sdk' specified could not be found.
error MSB4236: The SDK 'Microsoft.NET.Sdk.Web' specified could not be found.

已经做过的操作：

• 删除了其他所有SDK，仅保留Visual Studio配套的.NET 9.0.302 SDK
• 将该SDK路径移至PATH环境变量首位
• 创建了global.json文件
• 尝试执行dotnet new classlib -n TestLib -f net9.0新建项目，同样返回上述错误

解决步骤 #

• 检查global.json版本配置
  确保global.json里的sdk.version和你安装的9.0.302完全一致，别写错版本号，格式参考：

  {
    "sdk": {
      "version": "9.0.302"
    }
  }
  

• 确认PATH环境变量实际生效
  修改PATH后必须新开命令提示符/终端（旧窗口不会加载新配置），执行echo %PATH%（Windows）或echo $PATH（Linux/macOS），验证.NET SDK路径是否排在最前面。Windows下VS配套的SDK路径通常是C:\Program Files\dotnet\或C:\Program Files (x86)\dotnet\，要确认是正确的路径。

• 查看dotnet CLI的实际版本
  在终端执行dotnet --version，检查输出是否为9.0.302。如果不是，说明PATH中的dotnet.exe不是对应SDK的版本，可能是残留旧文件或PATH配置未生效。

• 修复SDK安装
  打开Visual Studio Installer，找到已安装的.NET 9.0.302组件，点击“修改”后选择“修复”选项，重新修复SDK安装，确保所有CLI工具和文件完整。

• 尝试管理员权限（Windows）
  如果Visual Studio是用管理员权限运行，但终端是普通用户权限，可能存在路径访问限制。换成管理员权限打开终端，再执行dotnet build或dotnet new测试。

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