Visual Studio 2022中XAML Hot Reload在.xaml文件失效问题求助

问题现象 #

• 修改.xaml文件的文本内容后，保存或点击Hot Reload按钮，输出窗口提示No changes to code were made.，XAML变更完全不生效
• .xaml.cs文件的Hot Reload功能可正常工作
• 基于.NET MAUI基础模板创建的极简项目，应用内从未出现Hot Reload工具栏
• 已尝试官方故障排查流程、管理员身份启动VS，均无效果；XAML代码无错误提示，Hot Reload无报错，仅能通过重启应用窗口看到XAML修改效果
• 环境：Visual Studio 2022（目标框架net7.0-windows10.0.19041.0），已更新至最新版本

可行解决步骤 #

1. 校验项目Hot Reload核心配置 #

• 右键项目 → 属性 → 生成 → 确保勾选启用热重载（适用于 .NET 应用），并将下拉选项设置为在保存时应用热重载
• 打开项目的.csproj文件，确认存在以下配置，缺失则手动添加：

  <PropertyGroup>
    <HotReloadProfile>maui</HotReloadProfile>
    <EnableHotReload>true</EnableHotReload>
  </PropertyGroup>
  

2. 重置VS的MAUI组件 #

• 打开Visual Studio安装器，选择你的VS实例点击“修改”，取消勾选.NET Multi-platform App UI 开发组件，完成卸载后重启电脑
• 再次打开VS安装器，重新勾选.NET Multi-platform App UI 开发组件，完成安装后重启VS

3. 清理项目与VS缓存 #

• 删除项目目录下的bin和obj文件夹
• 关闭VS后，删除以下路径的缓存文件：
  • %USERPROFILE%\AppData\Local\Microsoft\VisualStudio\<你的VS版本号>\ComponentModelCache
  • %USERPROFILE%\AppData\Local\Temp\VSFeedbackIntelliCodeLogs
  • %USERPROFILE%\AppData\Roaming\Microsoft\VisualStudio\<你的VS版本号>\AutomationScripts

4. 排查项目配置损坏问题 #

• 创建一个全新的.NET MAUI基础模板项目，测试XAML Hot Reload是否正常工作，若新项目正常，说明原项目配置存在损坏，可逐步迁移代码到新项目
• 暂时切换调试目标为其他平台（如Android模拟器），启动项目后再切回Windows Machine，重新测试Hot Reload

5. 匹配Windows SDK版本 #

• 在VS安装器中检查是否安装了与项目目标10.0.19041.0一致的Windows SDK版本，若未安装，添加对应版本的SDK组件后重启项目

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