Blazor WebAssembly 调试依赖 Mono 运行时就绪事件 mono_wasm_runtime_ready 启动 DevToolsProxy 与 Chrome 的 WebSocket 连接，断点需 PDB 符号支持，变量求值通过 Roslyn 动态编译执行，排查需检查 script 标签、本地协议、WebSocket 连接及 C# 扩展配置。
Blazor WebAssembly 可以像普通前端应用一样在浏览器中调试，但因为运行在 Mono WebAssembly 运行时上，它需要额外的调试代理支持。关键在于让浏览器 DevTools 能和 .NET 运行时通信——这靠的是 DevToolsProxy 和 MonoProxy 协同工作。
确保调试环境就绪
Blazor WebAssembly 调试依赖 Mono 运行时完成初始化后才可启动。调试器会监听一个特殊事件：
-
mono_wasm_runtime_ready：这是
MonoConstants.RUNTIME_IS_READY的值，表示 WASM 运行时已加载完毕、JIT/AOT 准备就绪 - 只有收到该事件，
DevToolsProxy才会建立与 Chrome DevTools 的 WebSocket 连接（ideSocket）并开始转发调试消息 - 若断点不生效、变量显示为
undefined，优先检查控制台是否输出了mono_wasm_runtime_ready日志
在 VS Code 或浏览器中设置断点
断点实际分两层解析：
- 你在
.razor或.cs文件中点击左侧设的断点，会被映射到源码对应的 序列点（Sequence Point） -
DebugStore模块负责维护所有源文件、方法符号和作用域信息；TryResolve()方法会尝试匹配断点位置是否落在某个已知序列点上 - 如果断点灰色不可用，常见原因是：PDB 符号文件未生成、
dotnet build未启用调试信息（检查项目是否含portable
调试时查看变量和执行表达式
变量监视和“控制台中执行 C# 表达式”功能由 EvaluateExpression 模块实现，流程如下：
- 输入表达式（如
user.Name或DateTime.Now.ToString()）后，调试器用 Roslyn 解析语法树 - 查找当前作用域（比如组件实例、局部变量）中的真实值，做变量替换
- 动态生成一个临时类和方法，编译成内存中的程序集，再调用执行
- 注意：不能执行修改状态的语句（如
user.Name = "test"），也不支持await—— 因为是同步求值，且无上下文捕获
排查常见调试失败问题
如果 F5 启动没反应、断点不命中、调用栈为空，可按顺序检查：
- 确认
index.html中的 Blazor标签没有加autostart="false"（除非你手动调用Blazor.start()） - 检查浏览器地址栏 URL 是否为
https://localhost:xxx或http://localhost:xxx—— HTTP/HTTPS 非本地回环地址可能被安全策略阻止调试连接 - 打开浏览器开发者工具 → Network 标签，过滤
ws，看是否有两个 WebSocket 连接成功：一个连向devtools（前端），一个连向mono（后端） - VS Code 用户需确保安装了最新版 C# 扩展，并在项目根目录有
.vscode/launch.json配置指向browser类型启动器
基本上就这些。Blazor WebAssembly 调试不是黑盒，而是基于标准协议（CDP）+ Mono 调试接口的一套透明链路，理清代理、作用域、表达式三者的协作关系，大部分问题都能定位。
