Visual Studio for Mac运行.NET MAUI报错：Workload ID maui未识别

1. 检查并配置.NET工作负载源 #

Homebrew安装的.NET可能未默认配置微软官方工作负载源，导致无法识别maui工作负载ID。执行以下命令添加官方源：

dotnet workload source add --name microsoft --address https://dotnetfeed.blob.core.windows.net/dotnet/index.json

添加后验证源是否生效：

dotnet workload source list

2. 搜索并安装正确的MAUI工作负载 #

先搜索可用的MAUI相关工作负载，确认正确的ID：

dotnet workload search maui

在搜索结果中选择对应工作负载，优先安装完整MAUI套件：

sudo dotnet workload install maui

若仍提示ID不识别，尝试单独安装MacCatalyst专属工作负载：

sudo dotnet workload install maui-maccatalyst

3. 验证工作负载安装状态 #

安装完成后，执行命令确认工作负载已正确安装：

dotnet workload list

确保输出中包含maui和maui-maccatalyst相关条目。

4. 修复VS for Mac包还原问题 #

完成工作负载安装后回到VS for Mac：

• 右键解决方案，选择还原NuGet包
• 若问题仍存在，执行项目 > 清理，再重新还原并生成项目
• 检查项目文件（.csproj），确认目标框架配置正确：<TargetFramework>net8.0-maccatalyst</TargetFramework>，无拼写错误

5. 额外排查项 #

• 确保Xcode已完成首次启动配置：打开Xcode，完成组件安装、许可协议同意等步骤
• 确认VS for Mac的.NET SDK路径设置正确：在偏好设置 > SDK位置.NET中，选中Homebrew安装的/usr/local/Cellar/dotnet/8.0.1/libexec/sdk
• 若上述步骤无效，尝试重装.NET SDK：

  brew uninstall dotnet
  brew install dotnet
  

  重装后重新执行工作负载安装流程

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