企业官网建设流程全解析

aspnetcore 仓库运行 restore.cmd 报 MSB4236 无法找到 .NET Core SDK 怎么排查？

【免费下载链接】aspnetcoreASP.NET Core is a cross-platform .NET framework for building modern cloud-based web applications on Windows, Mac, or Linux.项目地址: https://gitcode.com/GitHub_Trending/as/aspnetcore

在 aspnetcore 仓库中执行.\restore.cmd或.\build.cmd时，可能遇到下面这两行错误：

error : Unable to locate the .NET Core SDK. Check that it is installed and that the version specified in global.json (if any) matches the installed version. error MSB4236: The SDK 'Microsoft.NET.Sdk' specified could not be found.

这表示当前命令行环境找不到仓库要求的 .NET SDK。该仓库构建使用的是预览版 .NET SDK，由restore脚本自动安装到仓库根目录的.dotnet文件夹中，而不是依赖你机器上已有的 SDK。错误信息本身也给出了排查方向：确认 SDK 已安装，并且与global.json中指定的版本一致。下面按仓库文档给出的路径逐步排查。

报错时的背景：仓库如何定位 SDK

仓库根目录的 global.json 固定了 SDK 版本和查找路径：

• sdk.version：11.0.100-rc.1.26420.103（预览版，11.0.100-rc.1系列）；
• sdk.paths：[".dotnet", "$host$"]，即优先在仓库根目录下的.dotnet文件夹里找 SDK；
• sdk.errorMessage："The .NET SDK could not be found, run ./restore.cmd or ./restore.sh first."

也就是说，SDK 应由restore脚本装到本地.dotnet目录。只要这个目录里没有对应版本的 SDK，restore.cmd/build.cmd就会报 MSB4236。BuildFromSource 文档也说明了这一前提：仓库使用预览版 .NET SDK 构建项目，由restore脚本自动安装。

排查步骤

1. 确认本地.dotnet是否已由 restore 脚本安装

在仓库根目录重新执行一次完整的 restore：

# Windows .\restore.cmd

# Linux 或 Mac ./restore.sh

restore 完成后，检查仓库根目录下是否存在.dotnet\dotnet.exe（Linux/Mac 为.dotnet/dotnet）。一个现成的判断方式是用 dot-source 方式激活本地环境（注意. ./activate.ps1前面是“点、空格”，不能直接运行该脚本）：

# Windows . ./activate.ps1

# Linux 或 Mac source activate.sh

activate.ps1 会在激活后输出以下两种结果之一：

• .dotnet\dotnet.exe不存在时输出：.NET Core has not been installed yet. Run <仓库根目录>\restore.cmd to install it.—— 说明 restore 尚未成功装好 SDK，继续排查 restore 本身的报错；
• 存在时输出：dotnet = <仓库根目录>\.dotnet\dotnet.exe，并提示Enabled the .NET Core environment. Execute 'deactivate' to exit.。

看到后者，说明本地 SDK 已就位，此时重新运行.\restore.cmd或.\build.cmd验证是否不再报 MSB4236。

2. 在 Visual Studio 中启用 .NET Core SDK 预览版本

BuildErrors 文档指出，MSB4236 在大多数情况下是因为 Visual Studio 2019 中Use previews of the .NET Core SDK选项未勾选。处理方法是：

1. 启动 Visual Studio；
2. 进入Tools > Options；
3. 在Environment > Preview Features下勾选Use previews of the .NET Core SDK。

原因可以结合global.json理解：仓库锁定的是11.0.100-rc.1预览版 SDK，如果 Visual Studio 不允许使用预览版 SDK，就会解析不到Microsoft.NET.Sdk，产生同样的报错。

3. 仓库是较早克隆的：清理残留的 .dotnet 和 .tools

BuildErrors 文档还针对旧克隆给出了一条路径：如果你是在较早前克隆的仓库，运行restore.cmd出现构建错误时，尝试删除仓库根目录下的.dotnet和.tools两个目录，可能是旧版 .NET SDK 与当前版本不兼容。

注意副作用：这两个目录是 restore 生成的本地工具链和 SDK，删除后需要重新完整运行一次.\restore.cmd才会重新安装，属于“删本地文件 + 重新下载工具链”的操作，仓库源码不受影响。

另外，文档建议在不同 commit 之间切换 checkout 时执行git clean -xddff，避免旧构建资产与新提交冲突。该命令会删除仓库中的未跟踪文件（包括本地产物），如提示文件被锁失败，文档给出的办法是先停掉正在运行的dotnet或.NET Host进程再重试。

验证是否解决

按文档描述的成功标准核对：

1. 重新执行.\restore.cmd（Windows）或./restore.sh（Linux/Mac），不再出现error MSB4236和Unable to locate the .NET Core SDK；
2. . ./activate.ps1后输出dotnet = <仓库根目录>\.dotnet\dotnet.exe，说明命令行已指向仓库本地安装的 SDK。

满足以上两点后，即可按 BuildFromSource 的常规流程继续构建：在需要构建的项目子目录运行.\build.cmd，需要测试时加-test参数。

适用边界

• 该排查针对 Windows 下.\restore.cmd/.\build.cmd报 MSB4236 的场景；Linux/Mac 对应./restore.sh，流程相同。
• 仓库构建依赖预览版 SDK，这是仓库的固有要求（见global.json与 BuildFromSource），不要试图把global.json改成稳定版 SDK 来“绕过”报错。
• 如果 restore 本身在下载工具链阶段就失败（例如网络不通），MSB4236 会伴随 restore 的下载报错出现，此时应先解决 restore 的原始报错，而不是按 SDK 未安装处理。

【免费下载链接】aspnetcoreASP.NET Core is a cross-platform .NET framework for building modern cloud-based web applications on Windows, Mac, or Linux.项目地址: https://gitcode.com/GitHub_Trending/as/aspnetcore