Blazor组件需满足文件名合法（首字母大写、.razor扩展名）、单一根元素、参数加[Parameter]标记、子内容用RenderFragment、启用交互模式；否则会编译报错或运行无效。
Blazor 组件不是“创建出来再注册”，而是写完就能用——只要文件名合法、结构合规、路径可访问，编译器自动识别为 ComponentBase 子类，无需手动注入、无需配置项、不依赖任何 Program.cs 修改。
怎么新建一个 .razor 文件才不会编译报错
新建文件时最容易踩的坑是命名和根元素。Visual Studio 或 VS Code 中右键目录 → “添加新项” → 选“Razor 组件”模板最稳妥；若手动建，必须确保：
- 文件扩展名严格为
.razor（不是.cs、.html或.cshtml） - 文件名首字母大写且符合 C# 标识符规则（如
MyCard.razor，不能叫my-card.razor或1card.razor） - 组件内 HTML 必须有且仅有一个根元素（
<div>、<code><section></section>、<article></article>都行，但不能并列两个<p></p>） - 如果加了
@page "/my-card"，该路径不能与其他页面冲突；纯复用组件（如MyButton.razor）可完全不写@page - 必需参数：直接加特性，如
[Parameter] public string Label { get; set; }，父组件未传会编译警告 - 可选参数：加默认值，如
[Parameter] public string Color { get; set; } = "primary"; - 事件回调：用
EventCallback<t></t>，如[Parameter] public EventCallback<string> OnSubmit { get; set; }</string>，内部调用OnSubmit.InvokeAsync("done") - 禁止在
[Parameter]的 setter 里写逻辑——它可能被反复调用，且不保证执行时机；改用OnParametersSet()生命周期方法 - 在
@code块中声明：[Parameter] public RenderFragment? ChildContent { get; set; } - 在模板中用
@ChildContent渲染，如：<div class="card">@ChildContent</div> - 使用时像这样传内容：
<mycard><p>这是卡片正文</p></mycard> - 支持多个命名片段（如
HeaderContent、FooterContent），只需多定义几个RenderFragment参数并手动在模板中插入对应位置 -
Found multiple root elements：说明组件顶层写了多个并列标签，比如直接写<h3>Title</h3> <p>Desc</p>—— 必须包一层<div> 或 <code><section></section> - 页面空白但无报错：检查是否漏了
@namespace导致命名空间不匹配，或父组件没加@using YourApp.Shared（当组件不在同一命名空间时） - 点击没反应：确认组件用了交互式呈现模式（
rendermode="InteractiveServer"或全局启用交互性），否则@onclick等事件不会绑定 - 样式不生效：scoped CSS（
MyComponent.razor.css）只对当前组件有效，若想全局覆盖，得写到wwwroot/css/site.css或用<style></style>块（不推荐）
[Parameter] 属性为什么父组件传值没反应
这是最常被忽略的语义陷阱：public string Title { get; set; } 是普通属性，框架不会监听它；只有标记 [Parameter] 的属性，才会在父组件传入新值时触发重渲染。
组件怎么接收子内容（类似 HTML slot）
Blazor 不叫 slot，叫 RenderFragment，它是表示一段可渲染内容的委托类型。
为什么组件用了但页面空白或报错“Found multiple root elements”
常见原因不是代码逻辑错，而是结构或作用域问题：
真正麻烦的从来不是“怎么写”，而是“为什么写了却没效果”——多数时候卡在命名规范、根元素约束、参数标记缺失或交互模式未启用这几个点上。
