Avalonia中ComboBox需确保数据源就绪、DataContext正确、SelectedItem时机恰当；基础绑定用ItemsSource+ItemTemplate，选中项需双向绑定且实现INotifyPropertyChanged。
Avalonia 中 ComboBox 的使用核心在于数据绑定和上下文管理，不是简单拖控件就能跑通。关键要确保三件事：数据源已就绪、DataContext 正确设置、SelectedItem 时机得当。
基础绑定：ItemsSource + ItemTemplate
ComboBox 默认只显示字符串，若要展示自定义结构（比如字典或对象），必须用 ItemTemplate 指定如何渲染每一项：
- 用
Dictionary<string, string>举例：在 ViewModel 中暴露属性public Dictionary<string, string> Dic1 { get; } = new() { ["zh"] = "中文", ["en"] = "English" }; - XAML 中写：
<ComboBox Items="{Binding Dic1}" FontSize="20">
<ComboBox.ItemTemplate>
<DataTemplate>
<TextBlock Text="{Binding Value}"/>
</DataTemplate>
</ComboBox.ItemTemplate>
</ComboBox> - 注意：Binding 路径是
{Binding Value}，因为每项是 KeyValuePair，Value 才是你要显示的文本
选中项绑定：SelectedItem 必须可读可写 + 通知变更
光有 Items 不够，用户选中后得能存下来。ViewModel 中需提供可双向绑定的属性，并用 ReactiveUI 或 Avalonia 自带的 INotifyPropertyChanged 实现通知：
React Best Practices 2 0.1.0
下载
React 与 Next.js 性能优化指南，源自 Vercel 工程团队。适用于编写、审查或重构 React/Next.js 代码时使用。
- 定义：
private string? _selectedLang;
public string? SelectedLang
{
get => _selectedLang;
set => this.RaiseAndSetIfChanged(ref _selectedLang, value);
} - XAML 绑定：
<ComboBox Items="{Binding Dic1}" SelectedItem="{Binding SelectedLang, Mode=TwoWay}"/> - ⚠️ 常见错误：构造函数里先填 Items 再设 SelectedItem —— 此时 UI 尚未加载，绑定未生效。应等视图初始化完成后再赋值，或改用延迟绑定
静态 vs 动态数据源：按场景选方案
数据是否固定，决定你用哪种绑定方式更稳：
-
枚举类静态列表（如 DataTypeEnum）：直接用
x:Static，最可靠
<ComboBox ItemsSource="{x:Static vm:MainWindowViewModel.DataTypes}" SelectedItem="{Binding DataType, Mode=TwoWay}"/> -
动态集合（如从 API 加载）：确保集合是
ObservableCollection<T>，且在数据加载完再设置 SelectedItem；也可加Delay=100避免竞态：
<ComboBox ItemsSource="{Binding DataTypeList, Delay=100}" SelectedItem="{Binding DataType2, Mode=TwoWay}"/>
模板进阶：显示多字段或带图标
想一行显示 Key + Value，或加图标/颜色？用 StackPanel 或 Grid 布局即可：
- 示例（Key + "+" + Value）：
<ComboBox.ItemTemplate>
<DataTemplate>
<StackPanel Orientation="Horizontal" Spacing="4">
<TextBlock Text="{Binding Key}" Foreground="Gray"/>
<TextBlock Text="+"/>
<TextBlock Text="{Binding Value}"/>
</StackPanel>
</DataTemplate>
</ComboBox.ItemTemplate> - 注意：此时
SelectedItem绑定的是整个 KeyValuePair，不是字符串，所以 ViewModel 属性类型也得是KeyValuePair<string,string>?
基本上就这些。不复杂但容易忽略 DataContext 和通知机制 —— 把 ViewModel 实例正确设给视图，属性改值时触发通知，ComboBox 就自然活了。
