Avalonia 中 RadioButton 不支持 GroupName,推荐用绑定同一 ViewModel 属性配合 EqualsConverter 实现互斥,或使用 Avalonia 11+ 的 RadioGroup 容器自动分组。

在 Avalonia 中,RadioButton 本身**不支持**类似 WPF 的 GroupName 属性。这是常见误区——Avalonia 没有内置的 GroupName 机制来跨容器自动分组。
用 Binding + 同一个 ViewModel 属性实现逻辑分组
最推荐、最符合 Avalonia MVVM 风格的方式是:让多个 RadioButton 绑定到 ViewModel 中的**同一个属性**(如 SelectedOption),并通过 IsChecked 的双向绑定自动互斥。
- 每个
RadioButton绑定IsChecked="{Binding SelectedOption, Converter={StaticResource EqualsConverter}, ConverterParameter=OptionA}" - 配合一个简单的
IValueConverter(比如判断当前值是否等于参数) - 点击任一按钮会更新
SelectedOption,其他按钮因绑定表达式失效而自动取消选中
用 RadioGroup 控件(Avalonia 11+ 推荐)
Avalonia 11 起引入了原生 RadioGroup 容器,可自动管理子项互斥:
- 把多个
RadioButton放在内即可自动分组 - 无需额外绑定或转换器,行为接近传统 GroupName
- 支持
SelectedItem和SelectedValue绑定,更简洁
避免使用 Name/FindName 手动控制(不推荐)
不要试图用 Name 在代码后台遍历并手动设置 IsChecked —— 这破坏 MVVM,难以测试,且在模板或重复容器中易出错。
- 无法响应数据变化,状态易不同步
- 违反 Avalonia 响应式设计原则
- 增加维护成本,尤其在
DataTemplate或ItemsControl中
注意:确保绑定路径和上下文正确
如果分组无效,大概率是绑定断开:
- 检查
DataContext是否正确继承(尤其嵌套控件) - 确认
SelectedOption是INotifyPropertyChanged属性 - 使用
RadioGroup时,确保子项是直接子元素(不被中间容器包裹)










