Uno Platform WinUI项目运行提示无法加载Microsoft.ui.xaml.dll如何解决

1. 修复项目创建阶段MSB1009（项目文件不存在）报错 #

• 检查.NET SDK版本：Uno WinUI 模板要求使用.NET 6 及以上版本SDK，执行dotnet --version确认版本，不符合要求先升级.NET SDK
• 重新安装Uno模板：先清理旧版本缓存再重新安装，执行以下命令：

  dotnet new uninstall Uno.ProjectTemplates.Dotnet
  dotnet new install Uno.ProjectTemplates.Dotnet
  

• 检查创建路径：不要在包含中文、空格、特殊符号的路径下执行项目创建命令，避免路径识别异常

2. 修复启动阶段Microsoft.ui.xaml.dll找不到的报错 #

该报错本质是Windows App SDK运行时依赖缺失或版本不匹配，按以下步骤排查：

• 确认Visual Studio组件安装完整：打开Visual Studio Installer，在「单个组件」分类下勾选「Windows App SDK C# 模板」以及「Windows 10 SDK (10.0.19041.0 及以上版本)」，缺失的组件补装后重启Visual Studio
• 匹配运行时架构：你当前选择的是x86架构，若你的系统是64位，可先切换到x64架构测试，确认运行时架构和项目启动架构一致
• 统一Windows App SDK版本：打开NuGet包管理器，确认解决方案下所有项目引用的Microsoft.WindowsAppSDK包版本完全一致，避免版本冲突
• 清理项目缓存重新生成：删除解决方案根目录下的所有bin、obj文件夹，右键解决方案选择「重新生成解决方案」后再启动调试
• 注意：Visual Studio 2019已不支持最新的Uno WinUI模板，若你使用VS2019，建议升级到Visual Studio 2022最新稳定版。

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