Blazor 中用
@foreach渲染集合是最直接的方式，但要注意它不自带键值跟踪，容易在集合更新时引发 UI 错误或状态丢失。
基础写法：安全渲染简单列表
确保集合非 null，避免运行时异常。推荐用空集合初始化，而不是 null。
在@code块中定义：
private List<string> Items = new();</string>模板中使用：
@foreach (var item in Items) { <div>@item</div> }
若需索引，改用 @for (int i = 0; i ，更可控
避免重复渲染问题：用 @key 指定唯一标识
@foreach默认按位置匹配 DOM 节点，添加/删除中间项会导致后续元素重用错误的组件实例（比如输入框失焦、状态错乱）。 给每个循环项加上
@key，指向稳定唯一的值（如 ID）：
@foreach (var user in Users) { <usercard user="@user"></usercard> }
不要用 @key="user.Name"这类可能重复或变化的字段 若没有 ID，可用
@key="Guid.NewGuid()"（仅限一次性静态列表，不适用于可更新场景）
配合状态更新：别直接修改原集合引用
Blazor 组件靠引用变化触发重新渲染。直接调用
Items.Add()不会自动刷新界面，除非显式调用
StateHasChanged()或用新集合替换。 推荐方式：生成新集合并赋值，触发自动重渲染
Items = new List<string>(Items) { "New Item" };</string>
或手动通知：Items.Add("New Item"); StateHasChanged();
对 IEnumerable类型，
@foreach会在每次渲染时重新枚举，注意性能和副作用（如 LINQ 查询未缓存）
替代方案：考虑 @bind
+ InputSelect
或虚拟滚动
当集合很大（如上千项）或需要交互筛选时，
@foreach可能卡顿。 下拉选择用
<inputselect tvalue="string"></inputselect>更轻量 长列表建议用第三方库（如
Radzen.Blazor的
Virtualize组件）或原生
<virtualize></virtualize>（.NET 6+）
<virtualize items="@Items">...</virtualize>自动只渲染可视区域，大幅提升性能
基本上就这些。@foreach 简单好用，关键在加 @key、换引用、避坑集合变更逻辑。
