Blazor WebAssembly应用支持在Chrome/Edge/VS Code中直接调试C#源码，前提是启用Source Link、嵌入PDB、使用Debug配置并确保inspectUri有效；断点可设于.razor.cs、@code块等任意位置，调试体验接近JS。
Blazor WebAssembly（WASM）应用在浏览器中运行的是编译后的 .NET IL 字节码，通过 WebAssembly 运行时执行。虽然它不直接运行原生机器码，但现代浏览器（Chrome、Edge、Firefox）已原生支持在开发者工具中调试 C# 源码——无需手动映射或反编译。
启用源码映射与调试支持
确保项目配置正确是调试的前提：
- 使用 Visual Studio 或 VS Code 创建的 Blazor WASM 项目默认已启用源码映射（Source Link + PDB 嵌入）
- 确认 launchSettings.json 中的
inspectUri存在且未被注释（VS 2022+ 默认开启） - 构建时需用 Debug 配置（Release 模式可能剥离调试信息）
- 启动应用后，浏览器地址栏应包含
__blazor_debugger__查询参数（由调试器自动注入）
在 Chrome/Edge 中直接断点调试 C#
打开浏览器开发者工具（F12），切换到 Sources 面板即可看到 C# 文件：
- 左侧文件树中展开 top → localhost → _framework → dotnet.wasm，下方会出现 your-app-name.dll 及其展开的 C# 源文件（如
Counter.razor.cs） - 点击任意 C# 行号左侧设置断点（实心圆点），刷新页面或触发对应逻辑即可暂停
- 调用栈、局部变量、监视表达式、逐语句（F10）/逐过程（F11）均与调试 JS 体验一致
- 注意：Razor 组件中的
@code块或独立.razor.cs文件均可调试，@functions同样支持
VS Code 中集成调试（推荐工作流）
安装 C# Dev Kit 和 Blazor WASM Debugging Extension 后，可实现一键 F5 启动并附加：
- 按 Ctrl+Shift+P 输入 “Blazor” 找到 “Blazor: Start Debugging” 命令
- 或直接按 F5，VS Code 会自动启动浏览器并附加调试器
- 断点可设在 C# 文件任意位置（包括
Program.cs的builder.Build().Run()之前） - 支持条件断点、日志点（Log Point）、异常断点（如启用“Common Language Runtime Exceptions”）
常见问题与绕过技巧
若看不到 C# 源文件或断点不命中，优先检查以下几点：
- PDB 文件未加载：查看浏览器控制台是否报 “Failed to load source map”；清空浏览器缓存并硬刷新（Ctrl+F5）
-
路径映射异常：检查
dotnet.js加载时是否输出类似Loaded debug symbols for MyApp.dll日志 -
Razor 编译模式：确保未启用
<RazorCompileOnBuild>false</RazorCompileOnBuild>，否则生成的中间代码可能缺失调试信息 - 临时验证：在 C# 方法开头加
Console.WriteLine("hit");，看浏览器控制台是否输出，确认代码确实执行
基本上就这些。Blazor WASM 的调试体验已相当成熟，关键在于环境配置到位和浏览器支持开启。不需要额外插件（旧版除外），也不依赖本地 dotnet 进程——所有调试都在浏览器内完成。
