.NET Runtime 构建排障速查5 个高频 build.sh 报错一次解决【免费下载链接】runtime.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps.项目地址: https://gitcode.com/GitHub_Trending/runtime6/runtime刚把 dotnet/runtime 仓库 clone 下来build.sh一跑就报错这个仓库是 .NET 跨平台运行时的源码构建跑通是一切开发的前提。本文按环境自检 → 最小构建命令 → 高频报错速查的完整链路对准最常见的 5 个建不起来的坑。⚡️ 构建前自检先对照这 5 项前置条件构建失败的大头是环境前置条件缺失先过一遍清单再动手检查项要求快速确认命令内存≥1GB512MB 的虚拟机已知会失败free -h磁盘clone 后约 1~1.5GB单次构建再占 10~20GBdf -hCMake≥3.26Ubuntu 22.04 的 apt 只有 3.22cmake --version编译器工具链Linux 需要llvm、lld、clangmacOS 需要 Xcode CLTclang --versionGitWindows 上 ≥2.22且要开启长路径git --versionLinux 上可以用仓库自带脚本一次装齐依赖需要 sudo不用逐个 apt./eng/common/native/install-dependencies.sh不想动系统环境备选方案是用 官方 Docker 镜像。各平台的完整依赖清单在 平台要求文档。️ 最小构建命令只建 clrlibs别全仓构建全仓一次构建又慢又吃磁盘日常开发按 subset 只建你改的部分./build.sh -subset clrlibs -configuration Release -runtimeConfiguration DebugWindows 上换成build.cmd。subset 用连接常用的有clrCoreCLRCoreLib、libs类库、host、packs。产物落在artifacts/bin/coreclr/OS.Arch.Config重点看两个corerun和System.Private.CoreLib.dll。subset 与配置标志速记标志作用-c / --configuration所有 subset 的统一配置Debug / Release / Checked-rc / -lc / -hcruntime / libraries / host 各自独立配置-arch目标架构默认当前机器-h查看全部标志与示例Checked是 CoreCLR 专属配置带优化的同时保留断言跑测试最合适。⚙️ 两个容易踩错的设置SDK 版本与警告即错误SDK 版本。global.json 把 SDK 钉在11.0.100-rc.1本机没有对应版本时不用手动装让仓库自己拉取即可./eng/common/dotnet.sh # Linux / macOS eng\common\dotnet.cmd # Windows警告即错误。仓库默认把警告含代码风格类当错误处理一个未使用变量就能卡住构建。在你本机设置环境变量即可不用改仓库里任何文件TreatWarningsAsErrorsfalseapphost 陷阱单独建 clr 时的隐性炸弹只传-rc/-lc构建 clr 时连带构建的apphost会默认落在 Debug之后构建测试会因为配置对不上而失败。解法构建 clr 时始终同时带上-c例如-subset clr -c Debug。 高频报错速查表报错关键字大概率原因处理命令/参数The required .NET SDK wasnt found本机 SDK 与 global.json 钉住版本不符./eng/common/dotnet.shUnix/eng\common\dotnet.cmdWindowsCMake 版本检查失败低于 3.26旧版 Ubuntu 的 apt 只有 3.22snap install cmakeUnable to create file: Filename too longWindows 未开启长路径clone 阶段就会触发git config --system core.longpaths true并在系统设置里开启 Windows 长路径构建卡死或 OOM 退出内存不足 1GB升到 ≥1GB或改单次只建一个 subset大批风格警告直接中断构建默认警告即错误TreatWarningsAsErrorsfalse本地构建通过后如果 CI 又报红先看 CI 失败分诊文档完整日志都在artifacts/log下。 还卡住时先做这两件事再提问提 issue 之前先跑一次./build.sh -h对照 workflow 指南 核对参数并把artifacts/log下对应日志的关键段贴进报告。怀疑运行时或类库 bug提交到项目 issue 区附上最小可复现的 subset 命令构建环境问题从 平台要求文档 逐项对多数情况是依赖缺一项【免费下载链接】runtime.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps.项目地址: https://gitcode.com/GitHub_Trending/runtime6/runtime创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/9 14:36:38 · 阅读 1.2k .NET Runtime 构建排障速查：5 个高频 build.sh 报错一次解决
.NET Runtime 构建排障速查5 个高频 build.sh 报错一次解决【免费下载链接】runtime.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps.项目地址: https://gitcode.com/GitHub_Trending/runtime6/runtime刚把 dotnet/runtime 仓库 clone 下来build.sh一跑就报错这个仓库是 .NET 跨平台运行时的源码构建跑通是一切开发的前提。本文按环境自检 → 最小构建命令 → 高频报错速查的完整链路对准最常见的 5 个建不起来的坑。⚡️ 构建前自检先对照这 5 项前置条件构建失败的大头是环境前置条件缺失先过一遍清单再动手检查项要求快速确认命令内存≥1GB512MB 的虚拟机已知会失败free -h磁盘clone 后约 1~1.5GB单次构建再占 10~20GBdf -hCMake≥3.26Ubuntu 22.04 的 apt 只有 3.22cmake --version编译器工具链Linux 需要llvm、lld、clangmacOS 需要 Xcode CLTclang --versionGitWindows 上 ≥2.22且要开启长路径git --versionLinux 上可以用仓库自带脚本一次装齐依赖需要 sudo不用逐个 apt./eng/common/native/install-dependencies.sh不想动系统环境备选方案是用 官方 Docker 镜像。各平台的完整依赖清单在 平台要求文档。️ 最小构建命令只建 clrlibs别全仓构建全仓一次构建又慢又吃磁盘日常开发按 subset 只建你改的部分./build.sh -subset clrlibs -configuration Release -runtimeConfiguration DebugWindows 上换成build.cmd。subset 用连接常用的有clrCoreCLRCoreLib、libs类库、host、packs。产物落在artifacts/bin/coreclr/OS.Arch.Config重点看两个corerun和System.Private.CoreLib.dll。subset 与配置标志速记标志作用-c / --configuration所有 subset 的统一配置Debug / Release / Checked-rc / -lc / -hcruntime / libraries / host 各自独立配置-arch目标架构默认当前机器-h查看全部标志与示例Checked是 CoreCLR 专属配置带优化的同时保留断言跑测试最合适。⚙️ 两个容易踩错的设置SDK 版本与警告即错误SDK 版本。global.json 把 SDK 钉在11.0.100-rc.1本机没有对应版本时不用手动装让仓库自己拉取即可./eng/common/dotnet.sh # Linux / macOS eng\common\dotnet.cmd # Windows警告即错误。仓库默认把警告含代码风格类当错误处理一个未使用变量就能卡住构建。在你本机设置环境变量即可不用改仓库里任何文件TreatWarningsAsErrorsfalseapphost 陷阱单独建 clr 时的隐性炸弹只传-rc/-lc构建 clr 时连带构建的apphost会默认落在 Debug之后构建测试会因为配置对不上而失败。解法构建 clr 时始终同时带上-c例如-subset clr -c Debug。 高频报错速查表报错关键字大概率原因处理命令/参数The required .NET SDK wasnt found本机 SDK 与 global.json 钉住版本不符./eng/common/dotnet.shUnix/eng\common\dotnet.cmdWindowsCMake 版本检查失败低于 3.26旧版 Ubuntu 的 apt 只有 3.22snap install cmakeUnable to create file: Filename too longWindows 未开启长路径clone 阶段就会触发git config --system core.longpaths true并在系统设置里开启 Windows 长路径构建卡死或 OOM 退出内存不足 1GB升到 ≥1GB或改单次只建一个 subset大批风格警告直接中断构建默认警告即错误TreatWarningsAsErrorsfalse本地构建通过后如果 CI 又报红先看 CI 失败分诊文档完整日志都在artifacts/log下。 还卡住时先做这两件事再提问提 issue 之前先跑一次./build.sh -h对照 workflow 指南 核对参数并把artifacts/log下对应日志的关键段贴进报告。怀疑运行时或类库 bug提交到项目 issue 区附上最小可复现的 subset 命令构建环境问题从 平台要求文档 逐项对多数情况是依赖缺一项【免费下载链接】runtime.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps.项目地址: https://gitcode.com/GitHub_Trending/runtime6/runtime创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考