全新MAUI项目Windows调试时遇System.Runtime.WindowsRuntime加载失败问题求助

• 检查并修复NuGet包依赖

  • 右键项目→管理NuGet包，确认Microsoft.Windows.SDK.BuildTools和Microsoft.NET.Sdk.WindowsDesktop包已正确安装，版本需和项目的.NET MAUI版本匹配。
  • 清理NuGet缓存：打开命令提示符，执行dotnet nuget locals all --clear，之后右键项目选择「还原NuGet包」。

• 调整项目配置文件

  • 编辑项目的.csproj文件，添加以下配置强制指定程序集版本绑定：

    <ItemGroup>
      <PackageReference Include="Microsoft.Windows.SDK.BuildTools" Version="10.0.22621.756" PrivateAssets="all" />
    </ItemGroup>
    <PropertyGroup>
      <RuntimeIdentifiers>win10-x64;android-arm64</RuntimeIdentifiers>
    </PropertyGroup>
    <RuntimeHostConfigurationOption Include="System.Runtime.WindowsRuntime.BindingRedirects" Value="true" />
    

  • 同时确保.csproj中Windows目标框架正确，例如<TargetFrameworks>net8.0-android;net8.0-windows10.0.19041.0</TargetFrameworks>（根据你使用的.NET版本调整）。

• 重置Visual Studio调试环境

  • 关闭Visual Studio，删除项目目录下的bin和obj文件夹，重新生成解决方案。
  • 打开Visual Studio开发者命令提示符，执行devenv /ResetSettings重置设置（注意备份自定义设置），重启VS后再尝试调试。

• 检查Windows SDK版本

  • 打开Visual Studio安装器，确认已安装对应版本的Windows SDK（比如.NET 8对应Windows SDK 10.0.22621.x），缺失则补充安装。
  • 进入项目属性→生成→目标平台，确认Windows SDK版本选择正确，和已安装版本一致。

这个错误通常是程序集版本绑定冲突、NuGet包依赖缺失或Windows SDK环境配置不匹配导致的，WPF中出现类似问题也是因为相同的.NET桌面程序集加载机制问题，并非MAUI Windows版本的固有问题，大多属于环境配置层面的冲突。

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