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










