Avalonia CommunityToolkit.Mvvm怎么用 Avalonia MVVM工具包教程

Avalonia 配 CommunityToolkit.Mvvm 三步即可运行:安装 NuGet 包、继承 ObservableObject 并用 [ObservableProperty] 标记字段、XAML 中绑定属性与 [RelayCommand] 生成的命令,全程编译时源生成,无需反射、IOC 或手动通知。

用 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 支持好。