Blazor组件可变状态及参数属性修改是否有约定或最佳实践？

核心概念区分 #

Blazor 里对应 React 的 Props/State 有明确的概念划分：

• 组件内部状态（State）：由组件自身管理的可变数据，通常用私有字段或非[Parameter]标记的属性存储，更新时会触发组件重新渲染。
• 组件参数（Parameter）：标记[Parameter]的公共属性，由父组件传递数据，相当于 React 的 Props。但 Blazor 默认允许参数属性有公共 setter，这和 React 中 Props 只读的特性不同，也是你疑惑的核心点。

实现组件内不可修改的参数属性 #

针对“需要父组件传递但组件内部不可修改”的需求，有两种主流实践：

1. 使用 C# 9+ 的 init 关键字（推荐）

利用 C# 9 引入的 init-only 属性，从语法层面限制属性只能在初始化阶段赋值（父组件传递参数时属于组件初始化流程），组件内部无法修改：

[Parameter]
public string FixedParam { get; init; }

这种方式最简洁，直接杜绝了组件内部修改参数的可能，同时完全兼容父组件的参数传递逻辑。

2. 私有字段存储 + 约定式保护（兼容低版本 C#）

如果项目使用低于 C# 9 的版本，可以通过“私有字段存储参数值 + 公共属性仅暴露 getter”的方式，再配合开发约定保证组件内部不修改参数：

private string _fixedParam;

[Parameter]
public string FixedParam
{
    get => _fixedParam;
    // 父组件通过反射设置参数，私有 setter 仍可被框架调用
    private set => _fixedParam = value;
}

同时约定：组件内部永远不直接修改FixedParam，若需要基于该参数做可变操作，将值同步到内部状态字段后再修改：

private string _internalState;

protected override void OnParametersSet()
{
    // 父组件更新参数时，同步到内部状态（按需选择）
    _internalState = FixedParam;
}

// 组件内部仅修改内部状态
private void ModifyState()
{
    _internalState = "Updated Value";
    StateHasChanged(); // 手动触发渲染（部分场景下框架会自动调用）
}

关键最佳实践 #

• 严格区分参数与内部状态：参数是父组件的输入，组件应将其视为只读数据；可变逻辑全部放在内部状态中处理，避免参数与状态混淆导致的不一致问题。
• 禁止组件内部修改参数：Blazor 的参数更新由父组件驱动，组件内部修改参数会被父组件的重新渲染覆盖，引发难以排查的状态异常。
• 内部状态更新触发渲染：当通过异步操作或自定义事件修改内部状态时，若框架未自动触发渲染，手动调用StateHasChanged()即可。

内容的提问来源于stack exchange，提问作者acmoune