已安装Workload但Visual Studio Mac未识别，无法构建.NET MAUI项目

问题现象 #

更新Visual Studio Mac后，无法构建或调试.NET MAUI项目：

• 启动Visual Studio时提示「The solution requires .NET SDK Workloads that are not currently installed」，点击安装按钮输入管理员密码后无任何进度或结果反馈
• 包控制台报错NETSDK1147，要求安装maui-android workload
• 执行sudo dotnet workload restore显示成功但问题未解决
• dotnet workload list显示已包含maui-android等相关Workload，卸载重装所有Workload并重启机器后问题仍存在

解决方案 #

1. 验证.NET SDK与Visual Studio Mac版本兼容性 #

确保安装的.NET SDK版本与Visual Studio Mac版本匹配：

• Visual Studio Mac 17.6+ 需搭配.NET 7 SDK
• Visual Studio Mac 17.8+ 需搭配.NET 8 SDK
  执行dotnet --version查看当前SDK版本，若不匹配，卸载对应SDK并安装适配版本。

2. 彻底清理并重装.NET MAUI Workloads #

执行以下命令完全清理workload缓存后重新安装：

sudo dotnet workload uninstall --all
sudo rm -rf ~/.dotnet/workloads
sudo rm -rf ~/.dotnet/metadata/workloads
sudo dotnet workload install maui-android maui-ios maui-maccatalyst

3. 修复Visual Studio Mac组件安装 #

打开Visual Studio Mac，依次进入Visual Studio > Installer > Modify，确认以下组件已勾选并重新安装：

• .NET MAUI
• 对应项目目标版本的Android SDK
• iOS/Mac Catalyst相关组件

4. 检查项目目标框架配置 #

打开项目的.csproj文件，确认<TargetFramework>节点的值与当前.NET SDK版本一致，例如：

<TargetFrameworks>net8.0-android;net8.0-ios;net8.0-maccatalyst</TargetFrameworks>

5. 重置Visual Studio Mac用户数据 #

关闭Visual Studio Mac后，执行以下命令重置用户配置（替换17.0为你的VS Mac版本号，如17.8）：

rm -rf ~/Library/Application\ Support/VisualStudio/17.0

重新启动Visual Studio Mac后重新加载项目。

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