MudSelect绑定枚举多选时始终显示首个枚举项及文本函数不生效问题

两个异常本质是值类型枚举绑定MudSelect多选模式的常见适配问题，核心触发点有两个：

• 枚举属于值类型，默认值为对应数值0的枚举项。MudSelect默认对值类型的空选中状态做了fallback处理，会自动把default(TEnum)（也就是示例里值为0的Cat）当成选中值，哪怕你没有把它加入SelectedValues集合，组件内部校验也会默认渲染这个项。
• 原代码两处写法问题导致自定义文本失效：一是SelectedValuesChanged事件里直接对绑定的原集合做Clear再AddRange的操作，和组件内部持有的集合引用冲突，造成状态不同步；二是没有开启严格选中校验，组件拿到的实际选中列表永远包含默认0值项，MultiSelectionTextFunc永远收不到空集合入参，自然不会返回预期的"None"，最终出现隐藏input存了自定义文本、可见区域却渲染默认0值项的DOM异常。

按以下步骤调整即可解决全部问题：

1. 核心配置：开启严格选中模式
   给MudSelect组件加上StrictMode="true"参数，这个配置会让组件严格校验选中值是否存在于当前选中集合中，不会自动fallback到default(T)值，从根源解决0值枚举默认显示的问题。
2. 修正绑定逻辑，避免状态不同步
   优先使用@bind-SelectedValues做双向绑定，不要手动操作原集合的Clear、Add方法。如果必须自定义变更事件，直接给绑定属性赋值新的集合即可，不要复用原集合引用。
3. （推荐）枚举定义增加0值占位项
   业务枚举项不要占用0值，专门用0值作为未选中状态标识，从设计层面规避默认值误匹配问题，注意这个0值项不要渲染到下拉选项中。

修复后完整代码示例 #

// 枚举定义（推荐写法）
enum Animal
{
    None = 0, // 0值作为未选中占位，不加入下拉选项
    Cat = 1,
    Tiger = 2
}

<MudSelect
    T="Animal"
    Margin="Margin.Dense"
    Variant="Variant.Outlined"
    MultiSelection
    StrictMode="true" @* 必加核心配置 *@
    @bind-SelectedValues="SelectedValues"
    MultiSelectionTextFunc="FilterMultiSelectionTextFunc"
    Label="筛选">
    @* 遍历枚举时跳过0值占位项 *@
    @foreach(var value in Enum.GetValues<Animal>().Where(e => e != Animal.None))
    {
        <MudSelectItem T="Animal" Value="value">
            @value.ToString()
        </MudSelectItem>
    }
</MudSelect>

@code {
    // 初始化为空集合即可
    private HashSet<Animal> SelectedValues { get; set; } = new();

    private string FilterMultiSelectionTextFunc(List<string> items)
    {
        if (items.Count == 0)
        {
            return "None";
        }
        if (items.Count == 1)
        {
            return items[0];
        }
        return $"{items.Count} 项已选中";
    }
}

如果不想修改原有枚举定义（保留Cat=0的原有写法），不需要加0值占位项，只需要加上StrictMode="true"、修正集合绑定逻辑即可，组件在空选中状态下不会自动把0值项加入选中集合，MultiSelectionTextFunc可以正常收到空入参返回"None"，DOM中隐藏input和可见区域的文本会保持一致。

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