如何解决Blazorise中Autocomplete多选功能无法正常工作的问题

问题场景 #

• 实现目标：在Blazorise项目中实现Autocomplete多选功能，效果对齐官方示例
• 复现代码：直接引入官方提供的页面代码如下：

@page "/MultipleSelectPage"

<h3>MultipleSelect</h3>

<Autocomplete TItem="Country"
              TValue="string"
              Data="@Countries"
              TextField="@(( item ) => item.Name)"
              ValueField="@(( item ) => item.Iso)"
              Placeholder="Search..."
              Multiple
              FreeTyping
              @bind-SelectedValues="multipleSelectionData"
              @bind-SelectedTexts="multipleSelectionTexts">
</Autocomplete>

<Field Horizontal>
    <FieldBody ColumnSize="ColumnSize.Is12">
        Selected Values: @string.Join(',', multipleSelectionData)
    </FieldBody>
    <FieldBody ColumnSize="ColumnSize.Is12">
        Selected Texts: @string.Join(',', multipleSelectionTexts)
    </FieldBody>
</Field>

@code {
    [Inject]
    public CountryData CountryData { get; set; }
    public IEnumerable<Country> Countries;

    protected override async Task OnInitializedAsync()
    {
        Countries = await CountryData.GetDataAsync();
        multipleSelectionData = new List<string>() { Countries.ElementAt( 1 ).Iso, Countries.ElementAt( 3 ).Iso };
        await base.OnInitializedAsync();
    }

    List<string> multipleSelectionData;
    List<string> multipleSelectionTexts = new();
}

• 已做准备：补充了CountryData.cs等所有必要配套文件，逐行核对官方示例项目相关代码
• 异常现象：Autocomplete组件的Multiple属性显示红色错误标识，但编辑器未给出对应修复提示，项目可以正常编译运行
• 异常效果参考：

排查思路与解决方案 #

这类“编辑器标红但可正常编译”的问题属于Razor智能提示的假阳性报错，并非业务代码逻辑错误，按以下优先级排查即可：

• 统一Blazorise相关NuGet包版本
  检查项目内所有带Blazorise前缀的NuGet包（包括核心包、组件包、主题包、扩展包），确保所有包版本号完全一致。如果出现主包版本高、Autocomplete相关扩展包版本低的混装情况，智能提示会读取旧版本的组件元数据——旧版本Autocomplete未定义Multiple参数就会触发标红，但编译器可能通过依赖传递实际加载了新版本程序集，因此不会阻塞编译。
• 彻底清理项目与IDE缓存
  关闭当前打开的IDE，删除项目根目录下的bin、obj文件夹，再删除项目同级目录下IDE生成的缓存文件夹（Visual Studio对应.vs文件夹，VS Code对应.vscode文件夹）。重新打开IDE，等待依赖还原、项目索引完全加载完成后，再检查报错是否消失。
• 检查_Imports.razor命名空间引用
  确认项目根目录或当前页面对应目录下的_Imports.razor文件中，已经添加了@using Blazorise.Components命名空间。Autocomplete的多选相关参数定义在该命名空间下，缺少引用时智能提示无法识别参数定义，但Razor编译器编译时会自动扫描已加载的程序集类型，因此不会影响正常编译。
• 更新Razor语言服务/IDE版本
  旧版本的Razor语言服务对布尔型组件参数（即直接写属性名等价于属性名="true"的写法，比如示例中的Multiple、FreeTyping）存在识别bug，将IDE更新到最新稳定版本即可修复这类识别问题。

只要项目可正常编译运行、多选功能实际交互符合预期，这类标红不会影响生产环境表现，无需修改业务代码。

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