升级 .NET 10 SDK 后 dotnet workload 命令报“workload manifest 未安装”错误怎么解决
【免费下载链接】core.NET news, announcements, release notes, and more!项目地址: https://gitcode.com/GitHub_Trending/core82/core
用包管理器（package manager）把 .NET 10 SDK 升级到 10.0.101 或更高版本后，如果机器上此前已经安装过 workload（例如wasm-tools），再执行dotnet workload相关命令时可能会遇到如下报错：
Workload manifest microsoft.net.workload.mono.toolchain.net8: 10.0.100/10.0.100 from workload version 10.0.100.1 was not installed. Running "dotnet workload repair" may resolve this.以上是 release-notes/10.0/known-issues.md 中记录的文档示例错误信息，实际报错中的 manifest 名称和版本号可能不同，但只要出现 “Workload manifest ... was not installed” 这类提示，就可以对照本文处理。
先确认是否属于这个问题
这个已知问题的成因是：安装wasm-tools等 workload 时会依赖dotnet/sdk-manifests目录下的 manifest 文件，这些文件原本由 .NET SDK 安装时写入。通过包管理器升级 SDK 时，sdk-manifests里正在使用的文件会被移除，而 .NET SDK 现有的命令无法自动恢复它们，于是 workload 命令开始报错。
判断是否命中该问题，核对以下三点（均来自 release-notes/10.0/known-issues.md）：
- SDK 版本：运行
dotnet --version确认当前 SDK 是 10.0.101 或更高版本。该问题只影响这些版本。 - 升级方式：你是通过包管理器升级的 SDK。文档明确说明，通过 zip 或 tar 安装包、Mac PKG 安装、Windows 管理员安装这些方式不受影响，因为 manifest 在这些场景下会被保留。
- 此前装过 workload：机器上已经安装过某个 workload。
主路径：切换到 manifest 更新模式并更新
按以下顺序执行两条命令：
dotnet workload config --update-mode manifests dotnet workload update第一条命令把 workload 的更新模式切换为 manifests，第二条命令在 manifest 模式下重新拉取所需内容，补齐被包管理器升级删掉的 manifest。执行完dotnet workload update之后，问题即按文档记录被处理：你可以选择切回 workload-set 更新方式，也可以先保持 manifest 模式，直到该问题被上游修复为止。
如果执行上述命令后仍报同样的错误，文档给出了一步补充操作：删除dotnet/metadata文件夹后重试。这是一个删除目录的操作，只影响dotnet安装目录下的metadata缓存数据，删除后 workload 命令会重新下载所需的元数据；确认路径无误再执行。
替代路径：借助旧版 SDK 恢复 manifest
如果不方便切换更新模式，文档给出的替代方案是三步：
- 安装包含缺失 manifest 的上一版 .NET 10 SDK（该版本的安装会把缺失的 manifest 写回
sdk-manifests目录）； - 在两个 SDK 并存的情况下更新到目标的新版本；
- 更新完成后卸载临时安装的旧版 SDK。
这条路径会在系统中短暂同时存在两个版本的 .NET 10 SDK，操作完记得卸载旧版，避免后续dotnet --version出现版本歧义。
验证结果
用dotnet workload list查看当前已安装的 workload，确认 manifest 恢复正常。release-notes/10.0/install-workloads.md 中给出的文档示例输出如下：
> dotnet workload list Installed Workload Id Manifest Version Installation Source -------------------------------------------------------------------------------------------- maui 10.0.100-preview.1.25120/10.0.100-preview.1 SDK 10.0.100-preview.1以上为文档示例，你看到的 Manifest Version 与 Installation Source 取决于本机实际的 workload 和 SDK 版本。只要列表能正常输出、不再出现 “was not installed” 报错，说明修复成功。
如果需要确认可用的 workload 清单，可运行dotnet workload search查看完整列表；mauiworkload 会自动包含android、ios和maccatalyst，它们也可以单独安装。
限制与后续
- 该问题当前列在 release-notes/10.0/known-issues.md 的已知问题中，尚未给出修复版本时间表，建议后续升级前留意该文档的更新。
- 只要继续用包管理器升级 SDK，就可能再次触发同一问题；升级到 zip/tar 包、PKG 或管理员安装方式可以避免 manifest 被删，属于可选的长期规避手段。
- 错误信息中提示的
dotnet workload repair只是报错文本自带的建议命令，文档给出的官方处理路径是上面的--update-mode manifests方案或旧版 SDK 方案，按这两条路径执行即可。
【免费下载链接】core.NET news, announcements, release notes, and more!项目地址: https://gitcode.com/GitHub_Trending/core82/core
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
