MAUI Community Toolkit怎么用 MVVM库使用指南

煙雲 2025-12-18 00:00:00 次阅读

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/ 下查看源生成器实际产出的代码，方便理解底层逻辑