MAUI中用CommunityToolkit.Mvvm实现MVVM只需三点:装对包(CommunityToolkit.Mvvm 8.2.2+)、写对类(partial+ObservableObject+ObservableProperty/RelayCommand特性)、绑对DataContext(服务注入或页面级设置)。

MAUI 中用 CommunityToolkit.Mvvm 做 MVVM 开发,核心就三点:装对包、写对类、绑对 DataContext。它不是“配置一堆东西才能跑”,而是加个特性、继承一个基类,编译时自动生成通知和命令代码,轻量又高效。
安装 CommunityToolkit.Mvvm 包
必须用 NuGet 安装最新稳定版(如 8.2.2),不要用已废弃的 Microsoft.Toolkit.Mvvm。
- 在 MAUI 项目(.csproj)里添加:
- 确保启用 C# 11 源生成器支持,在项目文件中加入:
11.0 - 不用手动引用其他依赖,也不用改 TargetFramework —— 它自动适配 .NET 6/7/8 和 MAUI 运行时
定义 ViewModel 类
ViewModel 必须是 partial 类,继承 ObservableObject,再用特性标记字段即可。
-
[ObservableProperty]标记私有字段,自动生成带通知的 public 属性
例如:[ObservableProperty] private string _title = "首页";→ 自动生成Title属性并触发PropertyChanged -
[RelayCommand]标记方法,自动生成ICommand字段和执行逻辑
例如:[RelayCommand] private void Save() { ... }→ 自动生成SaveCommand属性 - 异步命令直接用
[RelayCommand]+async Task方法,会生成IAsyncRelayCommand - 不需要手写
INotifyPropertyChanged、SetProperty、new RelayCommand(...)等模板代码
在 MAUI 页面中绑定 ViewModel
MAUI 不像 WPF 那样默认支持全局资源字典,推荐两种主流方式:
-
页面级绑定:在
MainPage.xaml.cs构造函数中设置:BindingContext = new MainViewModel(); -
服务注入式绑定(更推荐):
在MauiProgram.cs注册:
builder.Services.AddSingletonainViewModel>();
然后在页面后台或 XAML 中解析:BindingContext = serviceProvider.GetService(); - XAML 中使用:
进阶但实用的功能点
几个高频但容易忽略的细节:
-
命令可执行控制:加
CanExecute参数,比如[RelayCommand(CanExecute = nameof(CanSave))],对应写一个返回bool的方法 -
消息通信:用
WeakReferenceMessenger替代传统事件,避免内存泄漏,无需手动解订阅 -
验证与状态:配合
ObservableValidator可快速实现属性级数据验证(如非空、长度限制) -
调试技巧:编译后可在
obj/Debug/net8.0/generated/下查看源生成器实际产出的代码,方便理解底层逻辑
基本上就这些。不复杂,但容易忽略 partial 和 LangVersion 这两个关键点。装完包、写好类、设好 BindingContext,就能立刻响应数据变化和按钮点击了。










