如何在VS Code中显示Xamarin调试错误并获取异常堆栈信息

Xamarin默认会吞掉页面导航、XAML运行时解析、ViewModel构造阶段抛出的未处理异常，不会触发进程崩溃，直接表现为跳转无响应、无任何错误提示。按以下步骤配置，即可在VS Code中实现类似Chrome调试控制台的效果，直接输出完整异常堆栈定位问题。

第一步：添加全局异常捕获逻辑 #

在共享项目App.xaml.cs的构造函数中，InitializeComponent()调用之前添加以下代码，捕获所有被框架吞掉的异常，输出完整日志到调试控制台：

AppDomain.CurrentDomain.UnhandledException += (sender, e) =>
{
    var ex = e.ExceptionObject as Exception;
    Debug.WriteLine($"[全局未捕获异常] {ex?.GetType()}: {ex?.Message}");
    // 递归输出所有内层异常，解决DI、XAML层的异常包装问题
    while (ex?.InnerException != null)
    {
        ex = ex.InnerException;
        Debug.WriteLine($"[内部异常] {ex.GetType()}: {ex.Message}");
    }
    Debug.WriteLine(ex?.StackTrace);
    // 调试状态下直接中断在异常抛出位置，和Chrome调试体验一致
    if (Debugger.IsAttached) Debugger.Break();
};

TaskScheduler.UnobservedTaskException += (sender, e) =>
{
    var ex = e.Exception;
    Debug.WriteLine($"[异步任务未捕获异常] {ex.GetType()}: {ex.Message}");
    while (ex.InnerException != null)
    {
        ex = ex.InnerException;
        Debug.WriteLine($"[内部异常] {ex.GetType()}: {ex.Message}");
    }
    Debug.WriteLine(ex.StackTrace);
    e.SetObserved();
    if (Debugger.IsAttached) Debugger.Break();
};

第二步：开启完整调试信息生成 #

打开共享项目的.csproj文件，在Debug模式对应的PropertyGroup节点下添加以下配置，确保XAML解析错误、编译期关联的运行时错误能输出准确的行号、文件位置信息：

<XamlDebuggingInformation>True</XamlDebuggingInformation>
<DebugType>full</DebugType>
<DebugSymbols>true</DebugSymbols>

第三步：配置VS Code调试规则 #

打开VS Code调试面板生成的launch.json文件，在对应的Xamarin/MAUI调试配置项中添加两个配置，让调试器捕获所有抛出的异常，而不是仅捕获未被处理的异常：

{
  "name": "调试Xamarin应用",
  "type": "maui",
  "request": "launch",
  "preLaunchTask": "build",
  "allExceptions": true,
  "breakWhenUnhandledExceptions": true
}

第四步（可选）：导航逻辑临时加错误捕获 #

如果全局捕获仍拿不到特定导航路径的异常，可以给导航代码加临时try-catch包裹，直接输出导航阶段的错误：

try
{
    await Shell.Current.GoToAsync(nameof(TargetPage));
    // 如果用的是NavigationPage就替换成下面的写法
    // await Navigation.PushAsync(new TargetPage());
}
catch (Exception ex)
{
    Debug.WriteLine($"[导航失败] 跳转TargetPage出错：{ex.Message}");
    Debug.WriteLine(ex.StackTrace);
    if (Debugger.IsAttached) Debugger.Break();
}

日志查看位置 #

配置完成后调试运行应用，直接打开VS Code的调试控制台面板，就能看到所有异常的类型、错误信息、完整调用堆栈：

• XAML运行时错误会明确标注出错的XAML文件、行号，比如静态资源不存在、属性绑定类型不匹配、XAML标签语法错误
• ViewModel构造函数抛出的异常会完整展示构造流程中的调用栈，包括依赖注入解析失败、空引用、参数错误等具体问题
• 触发Debugger.Break()时，调试器会直接中断在错误源头代码行，和Chrome DevTools的异常断点体验完全一致

注意：依赖注入解析服务、XAML解析器抛出的异常通常会包裹2-3层外层异常，一定要遍历到最内层的InnerException才能拿到真正的错误根因，不要只看最外层的异常信息。

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