第一个现场:设备列表页的「保存」按钮,从打开程序起就一直是灰的。选中一行,还是灰的。代码里明明写了「没有选中就不让点」,选中事件里也改了 _hasSelection,但按钮不会重新问一遍能不能点。WPF 的 ICommand 不是每次界面刷新都去调 CanExecute,你得主动告诉它「条件变了,重新判断」。
第二个现场更常见:一段「设备编号必须是 8 位、且不能重复」的校验,想看它有没有 bug,只能启动程序、点新建、填错、点保存、看弹窗。想连续试十组边界数据,得点十遍。逻辑和 MessageBox、TextBox 粘在一起,就没法单独测。
这两个问题指向同一件事:界面和逻辑没有边界。MVVM 要做的不是引入一堆新名词,是把「状态」和「操作」搬到一个不依赖窗口的类里,让界面只负责显示,让逻辑可以脱离界面运行和测试。这篇用一个「加载设备 + 选中后保存」的小程序把这套结构跑通,然后老实说清它的成本。
版本说明:按 .NET 8 WPF 讲,ICommand 来自 System.Windows.Input。本机用 dotnet-install.ps1 装了 .NET SDK 8.0.427,这个 MVVM 示例实际编译运行过,下面按钮状态的变化是点出来的。社区里更常用的做法是用 CommunityToolkit.Mvvm 的源生成器([ObservableProperty]、[RelayCommand])少写样板代码,本文先手写一遍,是为了让机制可见。
三层各管什么
「视图模型」这个词容易被理解成「界面的另一个写法」。它其实更像一个无界面的控制器:界面把「用户点了加载」翻译成一次方法调用,把「显示状态」翻译成绑定属性。因为它不引用 Window、MessageBox,所以能在单元测试里直接 new 出来。
有一处边界经常吵:业务规则放 Model 还是 ViewModel。我的经验是,跟数据本身绑定的规则(设备编号格式、状态流转是否合法)放 Model 或领域服务;跟「这一屏怎么用」有关的规则(没选中不让保存、加载中不让点)放 ViewModel。前者换个界面也要成立,后者换个界面就可能变。放错位置不会立刻报错,但会在第二个界面出现时暴露:规则被复制两遍,然后开始不一致。
这三层的边界不用靠目录来划,靠一个实际判断:ViewModel 文件里能不能出现 using System.Windows 或 new Window()。出现的那一刻,测试就得启动 STA 线程和 WPF 运行时,分层带来的收益开始打折。View 里出现业务计算,则说明方向反了。
场景走查:加载、选中、保存
需求:启动后点「加载」,模拟读三台设备;选中一台后「保存」才可用;保存时显示状态文字;加载期间两个按钮都不可点。先建一个 WPF 项目,然后添加三个类文件。
这篇不引入任何 NuGet 包,dotnet new wpf 生成的工程直接能编译。首行指定 net8.0,是因为本机只装了 SDK 8.0.427;如果你的机器只有更高版本的 SDK,把目标框架改成对应版本,代码本身不用动。
dotnet new wpf -n DeviceMvvm -f net8.0
cd DeviceMvvm
dotnet run
第一个文件是通知基类,负责在属性变化时发消息,并避免「值没变也通知」导致的重复刷新:
通知基类的核心是 Set 里那行相等判断:值没变就不发事件,避免界面做无谓的刷新。少了这一行,功能照跑,但每一次赋值都会触发一次绑定更新,列表大的时候能感到卡。
using System.ComponentModel;
using System.Runtime.CompilerServices;
public abstract class ViewModelBase : INotifyPropertyChanged
{
public event PropertyChangedEventHandler? PropertyChanged;
protected bool Set<T>(ref T field, T value, [CallerMemberName] string? name = null)
{
if (EqualityComparer<T>.Default.Equals(field, value)) return false;
field = value;
PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(name));
return true;
}
protected void Raise([CallerMemberName] string? name = null)
=> PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(name));
}
第二个是命令。RelayCommand 处理同步操作,AsyncRelayCommand 处理异步操作并防止重复点击:
using System.Windows.Input;
public sealed class RelayCommand : ICommand
{
private readonly Action<object?> _execute;
private readonly Func<object?, bool>? _canExecute;
public RelayCommand(Action<object?> execute, Func<object?, bool>? canExecute = null)
{
_execute = execute;
_canExecute = canExecute;
}
public bool CanExecute(object? parameter) => _canExecute?.Invoke(parameter) ?? true;
public void Execute(object? parameter) => _execute(parameter);
public event EventHandler? CanExecuteChanged;
public void RaiseCanExecuteChanged() => CanExecuteChanged?.Invoke(this, EventArgs.Empty);
}
public sealed class AsyncRelayCommand : ICommand
{
private readonly Func<Task> _execute;
private readonly Func<bool>? _canExecute;
private bool _running;
public AsyncRelayCommand(Func<Task> execute, Func<bool>? canExecute = null)
{
_execute = execute;
_canExecute = canExecute;
}
public bool CanExecute(object? _) => !_running && (_canExecute?.Invoke() ?? true);
public async void Execute(object? _)
{
if (!CanExecute(null)) return;
_running = true;
RaiseCanExecuteChanged();
try
{
await _execute();
}
finally
{
_running = false;
RaiseCanExecuteChanged();
}
}
public event EventHandler? CanExecuteChanged;
public void RaiseCanExecuteChanged() => CanExecuteChanged?.Invoke(this, EventArgs.Empty);
}
第三个是 ViewModel,把状态和操作集中起来:
using System.Collections.ObjectModel;
public sealed class MainViewModel : ViewModelBase
{
public ObservableCollection<Device> Devices { get; } = new();
public RelayCommand SaveCommand { get; }
public AsyncRelayCommand LoadCommand { get; }
private bool _isBusy;
private string _status = "就绪";
private Device? _selected;
public bool IsBusy
{
get => _isBusy;
private set
{
if (!Set(ref _isBusy, value)) return;
SaveCommand.RaiseCanExecuteChanged();
}
}
public string Status
{
get => _status;
private set => Set(ref _status, value);
}
public Device? Selected
{
get => _selected;
set
{
if (!Set(ref _selected, value)) return;
SaveCommand.RaiseCanExecuteChanged();
}
}
public MainViewModel()
{
LoadCommand = new AsyncRelayCommand(LoadAsync, () => !IsBusy);
SaveCommand = new RelayCommand(_ => Save(), _ => Selected is not null && !IsBusy);
}
private async Task LoadAsync()
{
IsBusy = true;
Status = "正在加载…";
try
{
await Task.Delay(800); // 换成真实的数据访问
Devices.Clear();
Devices.Add(new Device("PUMP-01", "在线"));
Devices.Add(new Device("PUMP-02", "离线"));
Devices.Add(new Device("VALVE-07", "在线"));
Status = $"已加载 {Devices.Count} 台设备";
}
finally
{
IsBusy = false;
}
}
private void Save()
{
// 真实项目在这里调用仓储或服务,失败时把原因写进 Status
Status = $"已保存 {Selected!.Name}";
}
}
public record Device(string Name, string Status);
界面只剩绑定和一行初始化:
<Window x:Class="DeviceMvvm.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
Title="设备管理" Height="460" Width="720">
<Grid Margin="16">
<Grid.RowDefinitions>
<RowDefinition Height="Auto"/>
<RowDefinition Height="*"/>
<RowDefinition Height="Auto"/>
</Grid.RowDefinitions>
<StackPanel Grid.Row="0" Orientation="Horizontal" Margin="0,0,0,12">
<Button Content="加载" Command="{Binding LoadCommand}" Padding="12,6"/>
<Button Content="保存" Command="{Binding SaveCommand}" Padding="12,6" Margin="8,0,0,0"/>
<ProgressBar Width="120" Height="4" Margin="16,0,0,0"
IsIndeterminate="{Binding IsBusy}"/>
</StackPanel>
<ListBox Grid.Row="1" ItemsSource="{Binding Devices}"
SelectedItem="{Binding Selected}">
<ListBox.ItemTemplate>
<DataTemplate>
<StackPanel Margin="4,6">
<TextBlock Text="{Binding Name}" FontWeight="SemiBold"/>
<TextBlock Text="{Binding Status}" Foreground="#667085"/>
</StackPanel>
</DataTemplate>
</ListBox.ItemTemplate>
</ListBox>
<TextBlock Grid.Row="2" Margin="0,12,0,0" Text="{Binding Status}"/>
</Grid>
</Window>
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
DataContext = new MainViewModel();
}
}
运行 dotnet run,预期:初始两个按钮里「保存」是灰的;点「加载」后进度条动 0.8 秒,列表出现三台设备;选中一台,「保存」变亮;点保存,底部状态变成「已保存 PUMP-01」。整个过程中 code-behind 没有一行业务判断。
实际跑起来后,按钮状态的变化和预期一致。为了把「选中才可删」也验证一遍,我在同一个示例里加了一个删除命令:初始 IsEnabled 为 False;点加载、列表里有了三台设备但还没选中,它仍然是 False;选中一行后变成 True;删掉这一行、选中项回到空,又变回 False。这个顺序说明 CanExecute 判定的是 Selected,不是集合里有没有数据。
CanExecute 不是每次界面刷新都被调用。WPF 在命令第一次绑定时问一次,之后靠 CanExecuteChanged 事件触发重新查询。所以状态变了却没人喊,按钮就一直保持旧的可点状态。RaiseCanExecuteChanged() 就是在喊这一声;它自己不判断条件,判断仍然发生在下一次 CanExecute 调用里。
注意 IsBusy 和 Selected 的 setter 里都调用了 SaveCommand.RaiseCanExecuteChanged()。这就是开头那个「按钮一直灰」的解药:按钮的可点状态不是自动轮询的,状态变了要有人喊一声。加载期间按钮变灰,靠的是 AsyncRelayCommand 内部的 _running 标记加上一次主动通知,而不是在 XAML 里绑 IsEnabled——两套机制混用会出现「按钮能点但命令不执行」或者「命令能执行但按钮灰着」。
这也解释了为什么把 RaiseCanExecuteChanged() 写在 setter 末尾最稳:无论状态是被代码改的、被绑定改的,还是被测试直接赋值的,setter 都会走到,通知不会漏。反过来,如果只在按钮的 Click 里通知,其他地方改了状态就没人管。
至于那个 ProgressBar,IsIndeterminate="{Binding IsBusy}" 只是把不确定进度条打开或关上,IsBusy 为 false 时它仍然占着位置,只是没有动画。真实项目里更常见的是绑 Visibility,但那需要值转换器;为了避免在这篇里塞进太多东西,先用占用位置的方式,界面不好看,行为是清楚的。
这里先把这版跑通,再谈优化。异步加载里那 0.8 秒是故意留的,目的是让 IsBusy 有可见的持续时间;真实项目里换成数据库或网络调用,界面线程的处理方式不变。
为什么 ViewModel 能测
把上面那个 ViewModel 放进测试项目,不需要启动窗口:
[Fact]
public async Task 未选中设备时不能保存()
{
var vm = new MainViewModel();
Assert.False(vm.SaveCommand.CanExecute(null));
vm.Selected = new Device("PUMP-01", "在线");
Assert.True(vm.SaveCommand.CanExecute(null));
}
[Fact]
public async Task 加载完成后设备数量正确()
{
var vm = new MainViewModel();
await vm.LoadCommand.ExecuteAsync(); // 仅为示例,实际用可等待的命令封装
Assert.Equal(3, vm.Devices.Count);
}
第二段测试要注意:ICommand.Execute 是 void,标准接口不给你等它的机会。示例里的 ExecuteAsync 需要你在 AsyncRelayCommand 上额外暴露一个返回 Task 的方法,测试才能确定加载结束。如果只依赖 Execute,测试里只能 await Task.Delay(...) 猜时间,那种测试既慢又不稳。
写测试时也别把绑定本身当成测试对象。单元测试该验证的是「给定状态,命令是否可用」「执行后状态变成什么」,而不是「XAML 里那条 Binding 写没写对」。后者属于界面联调,用一次手动点验或 UI 自动化更直接。把两类测试混在一起,会让测试又慢又脆,最后没人愿意维护。
测试里不需要 Application,也不需要窗口,因为 ViewModel 的构造函数不碰控件。这一点在写代码时就要守住:一旦构造函数里 new 了一个 Window 或读了 App.xaml 的资源,测试就会被迫初始化整个 WPF 运行时。
async void 是 MVVM 里最容易埋雷的地方。ICommand.Execute 的签名逼着你写 async void,而 async void 里抛出的异常不会被调用方捕获,会直接冒到未处理异常处理器,轻则弹错误框,重则进程退出。异步命令内部一定要 try/catch,或者把异常转成 ViewModel 上的错误状态,让界面显示出来。现象、原因与第一步
下表把这些现象按「命令没通知、命令不可用、逻辑粘界面」三类归好,方便先判断问题在哪一层。
| 现象 | 真实原因 | 第一步查什么 |
|---|---|---|
| 按钮一直是灰的,选中后也不变 | 命令的 CanExecuteChanged 没有触发,或 CanExecute 逻辑恒为 false | 在 CanExecute 里打断点,确认选中后是否被重新调用 |
| 点了保存没反应,也不报错 | CanExecute 返回 false 时 WPF 根本不调用 Execute | 先单独调 CanExecute(null) 看返回值,再查命令是否绑到了正确的 DataContext |
| 改完校验要重启才能测 | 逻辑写在 code-behind,依赖控件和弹窗 | 看这段代码是否引用了 MessageBox、TextBox 或具体窗口实例 |
| 加载中连点几次,数据重复 | 命令没有重入保护,或用 async void 直接并发执行 | 检查命令里是否有 _running 标记,按钮是否在加载期间禁用 |
| 窗口关了,程序还在后台跑 | ViewModel 订阅了静态事件或长生命周期对象的事件,没取消 | 搜索 += 订阅,确认窗口关闭时有没有对应 -= |
| ViewModel 越写越大,几千行 | 所有页面逻辑都塞进一个类,没有按功能拆分 | 数一下这个类里有多少个不相关的状态字段,按页面或子功能拆成多个 VM |
| 单元测试里 new 不出来 ViewModel | 构造函数里创建了窗口、读了配置文件或依赖静态单例 | 看构造函数做了什么,把外部依赖改成参数注入 |
别把 MVVM 做成教条
MVVM 的价值在两个地方:逻辑能脱离界面测试;界面改版时业务不受影响。它不保证代码一定清晰。见过不少项目,为了「符合 MVVM」,给每个字段包一层属性、给每个动作包一个命令,最后 ViewModel 比原来的 code-behind 长三倍,读起来要跳五层。分层是手段,不是目的。
另一个常见误区是把 ViewModel 当成「界面状态的镜像」,每个控件都对应一个属性。真实项目里 ViewModel 应该按业务概念组织:一个「设备会话」、一个「导入任务」,而不是「左上角标签的文字」「按钮的可用状态」。后者会让界面一改,VM 跟着全改。
还有一种「分层过度」的表现:为了解耦,引入消息总线,ViewModel 之间不直接调用,全发消息。刚开始很优雅,后来要追一个「保存后列表为什么没刷新」,得在代码里搜消息名、找订阅者、再找发布者,链路比直接调用长得多。只有当两个模块确实需要互不知道、或者订阅方数量会动态变化时,消息总线才划算。能用构造函数注入和直接方法调用说清楚的,不要绕。
另一个判断标准是看改动的频率:界面改版频繁、业务规则稳定,把规则放 ViewModel/Model 就划算;反过来,业务规则天天变、界面几个月不动,先让逻辑离界面近一点,等规则稳定再抽。架构是给变化留余地,不是给所有可能的变化提前付费。
边界与代价
第一,样板代码多。手写 INotifyPropertyChanged、命令类、每个属性的 setter,一个中等页面就是几百行基础设施。CommunityToolkit.Mvvm 这类库能用源生成器把大部分消掉,但引入库也意味着团队要理解它的约定,出问题时多一层排查。
第二,绑定是运行时的。属性名写错、DataContext 没设,编译期全不报错。MVVM 把越来越多的东西挪进绑定,等于把编译期能发现的错误推到了运行时。缓解办法是给关键绑定加兜底值、在启动时做一次断言、或者用能检查 XAML 的工具,但都无法完全消除。
第三,ICommand 是 WPF 的类型。ViewModel 一旦用了它,就绑死在 WPF(或 WindowsBase)上,想复用到 MAUI、Avalonia 或控制台测试,得换成抽象的命令接口。这不是大问题,但选型时要知道自己锁在哪。
第四,异步命令的边界仍然粗糙。ICommand 没有返回 Task,重入保护、异常处理、取消,都要自己实现一遍。写错就是「点了没反应」「重复提交」「进程崩溃」三种线上问题。
第五,MVVM 不解决内存泄漏。ViewModel 订阅了全局事件、静态集合、长生命周期的服务,窗口关了对象还在。桌面程序常开几天,泄漏会累积成「用久了越来越卡」。订阅和退订要成对写,或者在窗口关闭时显式清理。
第六,依赖注入不是 MVVM 自带的。WPF 没有内置容器,真实项目里要么自己写一个简单的服务定位器,要么引入 Microsoft.Extensions.DependencyInjection 这类库。引入之后,ViewModel 的构造函数会变成一串接口参数,测试是方便了,读起来也更绕。小项目用「在窗口里 new 一个具体服务」起步,等依赖真的多了再上容器,别为了形式感提前搭一套框架。
第七,MVVM 不会让界面变快。绑定的开销、命令的调用、属性通知,都是真实成本。它优化的是可维护性,不是渲染性能。列表卡顿、启动慢,仍然要回到布局、虚拟化和数据量上去查,别指望换成分层架构就能解决。
第八,MVVM 的调试路径更长。一个问题从界面传到命令、再到 ViewModel、再到服务,断点要打三四次;code-behind 里可能一眼就能看到。分层带来的可维护性,是用更长的调用链换来的,团队要接受这个成本。
小结与练习
MVVM 的骨架就三样:ViewModel 持有状态并对外通知,命令封装操作并声明何时可用,View 通过绑定和命令与它连接。真正的收益是可测试和可替换,不是代码好看。把 CanExecuteChanged、异步重入、异常兜底这三处处理好,比背分层图更有用。
验证边界:示例在 SDK 8.0.427 上编译运行过,按钮状态和加载过程都做了实际点验;单元测试片段是示例,没有在本机跑完整测试工程,这部分仍未验证,测试框架和断言行为以你自己的项目为准。
下面这些练习都可以基于本文这份三文件示例,不需要另建项目。
当天可以自己验证的练习:
- 运行示例,确认未选中时「保存」是灰的,选中后变亮;把
RaiseCanExecuteChanged()删掉,复现「一直是灰的」。 - 把
LoadAsync里的Task.Delay换成throw new Exception("模拟失败"),观察AsyncRelayCommand会怎么表现,再补上try/catch。 - 连续快速点「加载」五次,确认只会执行一次;去掉
_running判断再试一次。 - 为
Selected增加一条规则「离线设备不能保存」,改CanExecute并补一个单元测试。 - 把
MainViewModel里的Save改成调用一个接口IDeviceStore,在测试里传假实现,体会「不启动窗口就能测」。 - 把窗口的 code-behind 打印出来数一数,如果超过 20 行,找出哪些属于业务逻辑,想想它们为什么还没搬走。
下一篇讲本地文件、配置与 SQLite。界面和数据流分开了,接下来要解决数据放哪:配置文件写到哪里才不会因为权限失败,SQLite 怎么建表、怎么在版本升级时改结构而不丢用户数据。这些是桌面程序真正落地时必须过的关。