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未启用调试信息（检查项目是否含
<debugtype>portable</debugtype>）、或代码被修剪（trimmer 移除了调试元数据）
调试时查看变量和执行表达式
变量监视和“控制台中执行 C# 表达式”功能由
EvaluateExpression模块实现，流程如下： 输入表达式（如
user.Name或
DateTime.Now.ToString()）后，调试器用 Roslyn 解析语法树 查找当前作用域（比如组件实例、局部变量）中的真实值，做变量替换 动态生成一个临时类和方法，编译成内存中的程序集，再调用执行 注意：不能执行修改状态的语句（如
user.Name = "test"），也不支持
await—— 因为是同步求值，且无上下文捕获
排查常见调试失败问题
如果 F5 启动没反应、断点不命中、调用栈为空，可按顺序检查：
确认index.html中的 Blazor
<script></script>标签没有加
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 调试接口的一套透明链路，理清代理、作用域、表达式三者的协作关系，大部分问题都能定位。
