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

来源：这里教程网时间：2026-02-21 17:34:13 作者：

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<mainviewmodel>();</mainviewmodel>
XAML 中使用：
<label text="{Binding Title}"></label>

<button command="{Binding SaveCommand}"></button>

进阶但实用的功能点

几个高频但容易忽略的细节：

命令可执行控制：加
CanExecute
参数，比如
[RelayCommand(CanExecute = nameof(CanSave))]
，对应写一个返回
bool
的方法 消息通信：用
WeakReferenceMessenger
替代传统事件，避免内存泄漏，无需手动解订阅 验证与状态：配合
ObservableValidator
可快速实现属性级数据验证（如非空、长度限制） 调试技巧：编译后可在
obj/Debug/net8.0/generated/
下查看源生成器实际产出的代码，方便理解底层逻辑

基本上就这些。不复杂，但容易忽略