Blazor本质是通过WebAssembly或SignalR桥接运行C#代码，其核心差异在于执行位置与生命周期管理：Server端C#在服务端执行、UI更新靠SignalR推送差分指令；WASM端.NET运行时下载至浏览器本地执行。
Blazor 不是“用 C# 写前端”的魔法，它本质是靠 WebAssembly 或 SignalR 做运行时桥接 —— 你写的 ComponentBase 类不会直接变成 DOM，而是被 Razor 编译器转成 RenderTreeBuilder 指令流，再由渲染器解释执行。
Blazor Server 和 Blazor WebAssembly 的根本区别在哪？
核心不在语言，而在“谁执行 C# 代码”和“谁持有组件生命周期”：
- Blazor Server：C# 逻辑全在服务器跑，UI 更新靠 SignalR 推送
RenderBatch差分指令（JSON 格式），浏览器端只负责解析并 patch DOM。网络延迟敏感，OnInitializedAsync里的 IO 操作会阻塞整个用户会话连接。 - Blazor WebAssembly：.NET 运行时（
dotnet.wasm）下载到浏览器，C# 代码真正在客户端执行。首次加载体积大（约 2–4MB），但后续交互无服务端 round-trip；HttpClient默认走浏览器 fetch API，不自动携带 Cookie，需显式配置withCredentials: true。 - 两者共享同一套组件模型和 Razor 编译流程，但
NavigationManager的Uri解析、JSRuntime调用机制、依赖注入容器初始化时机都不同 —— 别在Program.cs里直接 new Service 实例，Server 端用AddScoped，WASM 端用AddSingleton更安全（避免跨线程问题）。
StateHasChanged() 什么时候必须手动调用？
它不是“刷新页面”，而是通知当前组件进入下一次渲染队列 —— 仅当变更发生在非框架接管的上下文时才需要：
- 从
IJSRuntime.InvokeVoidAsync回调中更新字段后，必须调用，因为 JS 回调脱离了 Blazor 渲染管线。 - 使用
Task.Run或ThreadPool.QueueUserWorkItem启动后台任务并修改@bind绑定的字段后，必须调用 —— 此时执行线程不是同步上下文（SynchronizationContext）所管理的渲染线程。 - 在
set访问器或事件回调（如@onclick）中改字段，不需要手动调用 —— Blazor 已在事件处理完毕后自动触发StateHasChanged。 - 误用后果：UI 不更新、输入框失焦、
InputText值卡住 —— 尤其在 JS 互操作后没调用，是高频 bug 来源。
Razor 编译后的 BuildRenderTree 方法到底干了什么？
你写的 .razor 文件会被 RazorSourceGenerator 编译为一个继承 ComponentBase 的类，并生成 BuildRenderTree 方法。它不返回 HTML 字符串，而是调用 RenderTreeBuilder 的一系列 OpenElement/AddContent/AddAttribute 方法，构造一棵轻量级的“渲染树描述对象”。
例如：
@if (show)
{
<div class="alert">Hello</div>
}编译后等价于：
builder.OpenIf(0, show); builder.OpenElement(1, "div"); builder.AddAttribute(2, "class", "alert"); builder.AddContent(3, "Hello"); builder.CloseElement(); // div builder.CloseIf(); // if
关键点：
- 每个
OpenElement的第一个参数是静态 slot ID，用于 diff 算法定位节点位置 —— 所以不要在循环里动态拼接组件（如@for中写<mycomp></mycomp>必须加@key，否则 slot 错位导致状态错乱）。 -
AddContent支持string、RenderFragment、object（会调用ToString），但不支持直接传async Task—— 这就是为什么@await DoSomethingAsync()在BuildRenderTree里非法，得用Task.FromResult包一层或移到OnInitializedAsync里。
真正难的从来不是怎么写一个 @page "/test"，而是理解 RenderTreeBuilder 如何把你的条件、循环、组件嵌套翻译成不可变的指令序列，以及这些指令如何被服务端或 WASM 渲染器消费。很多“状态不更新”“组件重复渲染”“JS 互操作后 UI 卡死”，追到底都是对这层抽象的误判。
