VS Code（Mac版）Maui项目构建报错NU1504：重复PackageReference

可能的原因及对应解决方案 #

1. 排查传递依赖重复引入 #

你未手动添加Microsoft.Maui.Controls，但项目中的其他NuGet包可能通过传递依赖多次引入该包。

• 打开终端进入项目根目录，执行命令查看完整依赖树：

  dotnet list package --include-transitive
  

• 在输出中定位Microsoft.Maui.Controls的所有引用来源，找到重复引入的上游包。可尝试更新该上游包到兼容版本，或在.csproj中添加以下配置覆盖重复引用：

  <PackageReference Include="Microsoft.Maui.Controls" Version="8.0.7" PrivateAssets="All" />
  

2. 检查.csproj中的隐式导入 #

MAUI项目常通过Sdk或Import标签隐式引入控件包，迁移时可能出现重复导入：

• 用VS Code打开.csproj文件，查找是否存在重复的类似标签：

  <Import Project="$(MSBuildExtensionsPath)\Microsoft\Maui\Microsoft.Maui.Controls.targets" />
  

• 删除多余的导入条目，仅保留一份。

3. 清理全局NuGet缓存 #

本地NuGet缓存损坏或存在重复包，可能导致解析异常：

• 执行终端命令清理全局缓存：

  dotnet nuget locals all --clear
  

• 清理完成后，执行dotnet restore重新恢复依赖。

4. 统一MAUI SDK版本 #

Mac上安装多版本MAUI SDK可能引发版本冲突：

• 执行命令查看已安装的MAUI workload：

  dotnet workload list
  

• 若存在多个8.x版本，卸载多余版本后重新安装指定版本：

  dotnet workload uninstall maui
  dotnet workload install maui --version 8.0.7
  

5. 校准VS Code的MSBuild环境 #

VS Code的MSBuild配置可能与VS for Mac存在差异：

• 打开VS Code命令面板（Cmd+Shift+P），选择Dotnet: Select Project SDK，确保选中与项目目标框架匹配的.NET 8 SDK版本。
• 关闭VS Code，删除项目根目录下的.vs（若存在）和.vscode文件夹，重新打开项目构建。

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