Visual Studio for Mac 17.4.3构建.NET MAUI项目失败求助

核心解决方案步骤 #

1. 明确指定.NET 7.0 SDK版本 #

在项目根目录创建或修改global.json文件，强制项目使用已安装的.NET 7 SDK，避免自动选择错误版本：

{
  "sdk": {
    "version": "7.0.401" // 替换为你本地`dotnet --info`中显示的具体.NET 7 SDK版本
  }
}

保存后重启Visual Studio for Mac并重新加载项目。

2. 修正项目文件配置 #

打开MAUI项目的.csproj文件，检查并调整以下配置：

• 确保TargetFrameworks指向MAUI专属的目标框架，而非纯.NET Framework：

<TargetFrameworks>net7.0-android;net7.0-ios;net7.0-maccatalyst;net7.0-windows10.0.19041.0</TargetFrameworks>
<TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">$(TargetFrameworks);net7.0-windows10.0.19041.0</TargetFrameworks>

• 移除任何指向.NETFramework,Version=v7.0的错误引用，MAUI项目无需依赖纯.NET Framework。

3. 清理项目缓存与重建 #

执行命令清理本地缓存：

dotnet clean
dotnet nuget locals all --clear

在Visual Studio for Mac中选择Build > Clean All，之后重新构建项目。

4. 验证VS for Mac的SDK关联 #

打开Preferences > .NET Core，确认已勾选.NET 7.0 SDK并设为默认。若存在未使用的旧版SDK，可考虑卸载以避免版本冲突。

5. 修复.NET SDK安装 #

运行命令检查并修复SDK：

dotnet sdk check

若检测到SDK损坏，重新下载对应版本的.NET 7.0 SDK本地安装包进行修复安装。

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