如何解决Visual Studio 2022 Preview中.NET MAUI的NuGet依赖错误？

问题情况 #

• 使用Visual Studio 2022 Preview开发.NET MAUI，新建项目后出现NuGet包依赖错误
• 尝试更新NuGet包时，更新按钮处于禁用状态，收到提示：

implicit reference by sdk. to update the package, update the sdk it belongs to

• 已确认.NET SDK为最新版本，且尝试过以下操作未解决：
  • 更新.NET SDK至最新版
  • 重新安装Visual Studio 2022 Preview
  • 重新下载所有NuGet包

解决步骤 #

1. 检查全局.json的SDK版本锁定 #

部分项目会通过global.json指定使用的SDK版本，即使安装了最新SDK，项目也可能沿用旧版本：

• 打开项目根目录的global.json（无此文件则新建）
• 将sdk.version修改为已安装的最新.NET MAUI兼容SDK版本，示例：

{
  "sdk": {
    "version": "8.0.100-preview.7.23376.3",
    "rollForward": "latestMajor"
  }
}

• 保存后重启Visual Studio，重新加载项目。

2. 手动编辑.csproj文件显式指定包版本 #

对于SDK隐式引用的包，可通过项目文件显式指定版本覆盖默认设置：

• 右键项目 → 编辑项目文件
• 在<ItemGroup>节点中添加或修改对应NuGet包的引用，示例：

<ItemGroup>
  <PackageReference Include="Microsoft.Maui.Controls" Version="8.0.0-preview.7.8842" />
  <PackageReference Include="Microsoft.Maui.Controls.Compatibility" Version="8.0.0-preview.7.8842" />
</ItemGroup>

• 保存文件，项目会自动还原包，之后检查更新按钮是否恢复可用。

3. 清理VS和NuGet缓存 #

• 关闭Visual Studio，删除%LOCALAPPDATA%\Microsoft\VisualStudio\<你的VS版本号>\ComponentModelCache目录下的所有文件
• 打开命令提示符，执行以下命令清理NuGet缓存：

dotnet nuget locals all --clear

• 重启Visual Studio，重新还原项目包。

4. 检查VS工作负载完整性 #

• 打开Visual Studio安装器，选择“修改”
• 确认“.NET Multi-platform App UI development”工作负载下的所有可选组件均已安装，尤其是与.NET MAUI SDK相关的预览组件
• 点击“修改”完成安装后重启Visual Studio。

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