Avalonia 本身没有内置的可搜索 ComboBox，但可以通过组合
TextBox、
ListBox和数据绑定 + 过滤逻辑，手动实现一个功能完整的“可搜索下拉框”。核心思路是：用文本框输入触发实时过滤，用弹出面板（如
Popup）展示匹配项，支持键盘导航和回车选择。
1. 使用 TextBox + Popup + ListBox 模拟可搜索下拉
这是最常用且可控性最强的方式。结构大致如下：
主区域：一个只读TextBox（显示当前选中值，点击时聚焦并展开下拉） 下拉层：用
Popup包裹
ListBox，绑定过滤后的数据源 搜索逻辑：监听
TextBox.Text变化，用
ICollectionView或
ObservableCollection<t></t>+ LINQ 动态过滤 交互支持：按上下键在列表中移动焦点，回车/鼠标点击确认选择，失焦或 Esc 关闭弹窗
2. 关键 XAML 结构示例
以下是一个简化但可运行的布局片段（需配合 ViewModel）：
<StackPanel>
<TextBox x:Name="SearchBox"
Text="{Binding SearchText, UpdateSourceTrigger=PropertyChanged}"
GotFocus="OnTextBoxGotFocus" />
<Popup x:Name="DropdownPopup"
IsOpen="{Binding IsDropdownOpen}"
PlacementMode="Bottom"
StaysOpen="False">
<Border Background="#FFFFFF" BorderBrush="#CCCCCC" BorderThickness="1">
<ListBox ItemsSource="{Binding FilteredItems}"
SelectedItem="{Binding SelectedItem, Mode=TwoWay}"
ScrollViewer.VerticalScrollBarVisibility="Auto">
<ListBox.ItemTemplate>
<DataTemplate>
<TextBlock Text="{Binding DisplayName}" />
</DataTemplate>
</ListBox.ItemTemplate>
</ListBox>
</Border>
</Popup>
</StackPanel>
3. ViewModel 中的关键逻辑（C#）
重点在于响应式过滤与状态同步：
定义SearchText属性，setter 中触发
FilterItems()
FilteredItems是一个
ReadOnlyObservableCollection<t></t>或用
ICollectionView（推荐
Avalonia.Collections.AvaloniaList<t></t>+ 手动刷新） 每次过滤后调用
NotifyOfPropertyChange(nameof(FilteredItems))
SelectedItem改变时，自动更新
SearchText并关闭弹窗 为支持键盘操作，在代码后台处理
KeyDown：Esc 关闭、Enter 选中高亮项、上下键移动 ListBox 选中项
4. 进阶建议：封装成自定义控件
若项目中多处使用，建议封装为
SearchableComboBox控件： 继承
TemplatedControl，定义
ItemsSource、
DisplayMemberPath、
SelectedItem等依赖属性 内部管理 Popup 生命周期、键盘事件、焦点流转 暴露
FilterFunc（
Func<object string bool></object>）让调用方自定义匹配逻辑（如支持拼音首字母、模糊匹配等） 参考开源实现：Avalonia.Controls 中的
ComboBox源码，或社区库如
Avalonia.Xaml.Interactions
不复杂但容易忽略的是焦点管理和 Popup 关闭时机——务必处理好 TextBox 失焦、Popup 外部点击、Esc 键这三类场景，否则体验会断开。
