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