需提升MSBuild日志等级至诊断级、配置AvaloniaXamlCompilerLogLevel为Diagnostic、确保XAML文件Build Action设为AvaloniaResource，并启用AOT保留策略及工具链详细输出。

在 Avalonia 中启用 XAML 编译（XAMLC）或 AOT 编译时，若出现编译错误但控制台未显示详细信息，通常是因为构建过程静默了 XAMLC 的诊断输出，或 AOT 工具链未开启详细日志。要让 XAMLC 和 AOT 编译错误清晰可见，需从 MSBuild 日志级别、项目配置和调试手段三方面入手。

开启 MSBuild 详细日志并捕获 XAMLC 输出

XAMLC 错误默认可能被归类为“警告”或低优先级消息，容易被忽略。可通过提升 MSBuild 日志等级强制显示：

• 在命令行构建时添加 /v:detailed 或 /v:diag（诊断级），例如：
  dotnet build -v:diag
• 在项目文件（.csproj）中显式启用 XAMLC 并增加诊断开关：
  

  <propertygroup><br><avaloniaenablexamlcompilation>true</avaloniaenablexamlcompilation><br><avaloniaxamlcompilerloglevel>Diagnostic</avaloniaxamlcompilerloglevel><br></propertygroup>

• 确保已引用 Avalonia.Diagnostics 包（尤其在开发阶段），它能增强 XAML 加载失败时的异常堆栈可读性。

检查 AOT 编译错误的常见位置

Avalonia 的 AOT（如通过 Microsoft.DotNet.ILCompiler 或 .NET 8+ NativeAOT）本身不直接编译 XAML，但会编译包含 XAML 初始化逻辑的 C# 代码。XAMLC 错误若未被提前拦截，可能在 AOT 阶段表现为 IL 分析失败或反射调用缺失。排查要点：

outlook-microsoft

微软 Outlook 邮箱和日历管理工具（支持世纪互联版 Office 365）。用于查看、发送、搜索邮件，管理日历日程，创建会议，查询忙闲状态。注意：此功能仅支持世纪互联（21Vianet）版 Microsoft 365，使用 login.chinacloudapi.cn。

下载

• AOT 会拒绝动态反射访问 —— 若 XAML 中绑定的属性/命令未被保留，NativeAOT 要求显式标注 [DynamicDependency] 或在 rd.xml 中保留类型；否则报错类似 “Could not resolve type … during AOT compilation”
• 确保所有 Styles、DataTemplates、UserControls 的类型都在 AOT 保留范围内，特别是通过 typeof(YourControl).Assembly 动态加载的程序集
• 在 .csproj 中启用 AOT 诊断：
  

  <propertygroup><br><publishaot>true</publishaot><br><ilcinvariantglobalization>false</ilcinvariantglobalization><br><ilcprintintrinsics>true</ilcprintintrinsics><br></propertygroup>

  其中 IlcPrintIntrinsics 可输出更多 IL 编译中间信息

在 IDE 中定位 XAMLC 实时错误

Visual Studio 或 Rider 对 Avalonia XAML 的设计时支持有限，XAMLC 错误往往只在构建时触发。提高可见性方法：

• 在 Tools → Options → Projects and Solutions → Build and Run 中将“MSBuild project build output verbosity”设为 Detailed
• 安装最新版 Avalonia for Visual Studio 扩展（v0.10.15+），它增强了 XAML 文件保存时的后台编译与错误波浪线提示
• 手动触发 XAMLC：在项目目录下运行
  dotnet avalonia.xamllinker --verbose YourApp.csproj（需先安装 Avalonia.Cli 工具）

验证 XAML 文件是否被正确识别和编译

部分 XAML 错误源于文件未参与 XAMLC 流程，比如 Build Action 设置错误：

• 在 Solution Explorer 中右键 XAML 文件 → Properties → 确认 Build Action = AvaloniaResource（不是 Page、Content 或 None）
• 检查是否误加了 Generator 属性（Avalonia 不使用 XamlGeneratedNamespace，应清空该字段）
• 若使用 App.xaml 或 MainWindow.xaml，确认其 x:Class 值与实际 C# 类名、命名空间完全一致，且对应 .xaml.cs 文件存在且无编译错误