用 Avalonia 配 CommunityToolkit.Mvvm 很直接:装包、写 ViewModel、绑定 View,三步就跑起来。它不依赖反射,靠源生成器在编译时自动补全通知逻辑和命令代码,轻量又高效。
安装与基础配置
在 Visual Studio 中右键项目 →「管理 NuGet 程序包」→ 搜索 CommunityToolkit.Mvvm → 安装最新稳定版(如 8.2.2)。支持 .NET 6/8+,Avalonia 11+ 兼容良好,无需额外引用或手动配置。
确保项目目标框架是 .NET 6 或更高版本 不用改 App.xaml.cs,默认初始化方式即可,无需注册 IOC 容器(除非你主动要用) 若之前用了 ReactiveUI 或其他 MVVM 包,记得卸载对应包,避免冲突写一个可响应的 ViewModel
新建类(如
MainViewModel.cs),继承
ObservableObject,用
[ObservableProperty]标记私有字段,生成器会自动创建带通知的公共属性:
[ObservableProperty] private string _title = "欢迎";→ 自动生成
Title属性及变更通知
[ObservableProperty] private bool _isEnabled;→ 支持双向绑定和界面实时刷新 需要验证时,可继承
ObservableValidator,配合
[Required]、
[MinLength(2)]等特性
绑定命令与交互逻辑
用
[RelayCommand]特性声明方法,生成器自动创建
ICommand属性并关联执行逻辑:
[RelayCommand] private void AddItem() { /* 实现 */ } → 自动生成 AddItemCommand属性 加
CanExecute参数(如
[RelayCommand(CanExecute = nameof(CanAdd))])→ 自动监听对应布尔方法返回值,控制按钮是否可用 异步操作用
[RelayCommand]标记
async Task方法 → 自动生成
IAsyncRelayCommand
View 中绑定数据和命令
Avalonia XAML 中通过
x:DataType声明 ViewModel 类型,启用编译时绑定检查: 在
MainView.axaml根元素加:
x:DataType="vm:MainViewModel"(需先 xmlns:vm 声明命名空间) 文本框绑定:
Text="{Binding Title, Mode=TwoWay}"
按钮命令绑定:Command="{Binding AddItemCommand}"
不要在后台代码(.axaml.cs)里手动设 this.DataContext = new MainViewModel(),否则可能干扰设计时绑定
基本上就这些。写法简洁,没冗余代码,也不用记一堆接口实现细节。重点是理解
[ObservableProperty]和
[RelayCommand]是编译期“写好”的,不是运行时靠反射拼出来的——所以快、安全、IDE 支持好。
