简介：面向WPF入门与进阶开发者的MVVM登录窗口完整示例，以登录场景串联MVVM核心机制，适合希望快速理解数据绑定、命令、验证与导航等实践的读者。压缩包共71个文件，以31个C#源文件为核心，配合XAML界面定义、配置文件、程序集与可执行文件等，清晰呈现项目结构；整体仅258KB，便于下载后直接打开解决方案研读。已有10153人学习下载，是社区中较受欢迎的WPF MVVM参考实现。示例涵盖ViewModel与View解耦、RelayCommand命令、PasswordBox安全绑定、RadioButton偏好设置、数据验证及登录成功后窗口切换等关键知识点；同时包含完整解决方案与项目文件，可在此基础上扩展为实际业务界面，帮助开发者少走弯路，快速建立MVVM落地思路。

1. WPF MVVM 登录窗口示例：一份能直接抄进项目的完整骨架

刚用 WPF MVVM 写登录窗口时，我一度怀疑这套模式是不是给人用的：文本框输入要绑定，按钮要命令，密码框还不让绑定……等我把整套示例跑通、把项目里那一堆登录逻辑拆干净之后，回头发现其实就三件事——数据从哪来、行为归谁管、视图怎么通知。这篇要拆的是一份 WPF MVVM 完整示例（登录窗口），它覆盖了分层项目结构、登录命令、字段校验、异步登录和登录成功后切换主窗体这条完整链路。适合刚入门想找范本的人，也适合那些被老项目事件驱动写法困住、打算手工迁移到 MVVM 的开发者——照着这份资源动手，比对着文档抽象概念快得多。

2. 先理解 MVVM 的三个角色：模型、视图模型与视图如何分工协作

很多人拿到登录窗口示例第一反应是“代码比我现在的还多”，这是因为 MVVM 把逻辑从视图里搬到了 ViewModel 里，代价是类多了，收益是登录逻辑不再和控件生命周期绑死。

2.1 三个角色的边界：为什么登录逻辑不能塞进按钮点击事件

传统写法里，登录按钮的 Click 事件里通常长这样：读两个文本框、拼参数、调服务、try/catch、弹窗提示、成功后跳转。这段代码在小型 Demo 里没问题，一旦项目变大，你会在每个需要登录的窗口里复制粘贴同一套逻辑，改一处校验规则要翻五个文件。

MVVM 的做法是拆成三个角色：

• Model：描述“数据是什么”。登录场景里就是用户名、密码、记住我标记，以及后端返回的用户信息实体。
• ViewModel：描述“这个界面有什么状态、能做什么”。它持有界面要显示的所有数据（用户名、密码、错误提示、登录中标记），也持有界面能触发的所有行为（登录命令、取消命令）。
• View：只负责“长什么样”。按钮不写 Click 逻辑，输入框不直接操作业务对象，View 里只剩 XAML 和少量纯 UI 行为的代码。

登录流程在 ViewModel 里的顺序大概是：用户输入用户名和密码 → 点登录按钮 → LoginCommand 执行 → 调 IAuthService 校验 → 成功改 IsLoggedIn 状态并触发跳转，失败把错误信息写进 ErrorMessage 属性。View 全程不关心校验规则是什么，它只负责把 ErrorMessage 显示出来。

提示：判断职责有没有分干净有个土办法——如果 ViewModel 里出现了 MessageBox、或者 View 的代码文件里出现了业务判断，说明分层已经越界了。

2.2 数据绑定与通知机制：界面怎么知道“该刷新了”

MVVM 能跑起来的基础是 WPF 的数据绑定。绑定的核心是 DataContext 继承：窗口的 DataContext 是 LoginViewModel 实例，窗口里所有控件如果没有单独指定 DataContext，就会顺着可视化树往上找，最终命中窗口的 LoginViewModel。

但绑定只是把属性名和控件属性连起来。ViewModel 的属性值变了，控件怎么知道？靠 INotifyPropertyChanged 接口。这个接口只有一个事件 PropertyChanged，ViewModel 每次给属性赋新值后触发它，WPF 收到事件后去刷新绑定目标。示例里的 ViewModel 基类一般长这样：

public abstract class ViewModelBase : INotifyPropertyChanged { public event PropertyChangedEventHandler? PropertyChanged; protected void OnPropertyChanged([CallerMemberName] string? propertyName = null) { PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName)); } protected bool SetProperty<T>(ref T field, T value, [CallerMemberName] string? propertyName = null) { if (EqualityComparer<T>.Default.Equals(field, value)) return false; field = value; OnPropertyChanged(propertyName); return true; } }

逻辑说明：SetProperty 做的事是先比较新旧值，值没变就不触发通知，避免界面做无用刷新；值变了才赋给字段并触发 OnPropertyChanged。CallerMemberName 让调用方不用手写属性名字符串，减少拼写错误。登录示例里 UserName、ErrorMessage、IsBusy 这些属性全部走这个方法赋值。

参数说明：propertyName 是可选参数，编译器会自动填入调用 SetProperty 的属性名。如果手动调用 OnPropertyChanged，建议显式传属性名字符串，不要依赖 CallerMemberName 之外的花招。

绑定方向也值得留意。TextBox 的 Text 属性默认是 TwoWay，也就是控件输入会写回源属性；但 TextBlock 的 Text 默认是 OneWay，只管显示。UpdateSourceTrigger 默认是 LostFocus，意味着输入框只有在失焦时才把值推回 ViewModel，如果你在点登录按钮前没让输入框失焦，拿到的是上一次的值。示例里最好把用户名和密码输入框都设成 UpdateSourceTrigger=PropertyChanged，让每次按键都同步。

2.3 命令：按钮点击背后的 ICommand 约定

按钮没有 Click 事件之后，靠什么响应点击？靠 Command。WPF 的 Button 自带 Command 属性，点击时 WPF 会调用命令的 Execute，同时可以用 CanExecute 控制按钮是否可用。ICommand 接口有三个成员：

• CanExecute：返回按钮是否可点。
• Execute：点击时真正执行的逻辑。
• CanExecuteChanged：CanExecute 结果变化时通知界面刷新按钮状态。

登录按钮非常适合用命令：密码为空时 CanExecute 返回 false，按钮自动置灰；填了密码后刷新 CanExecute，按钮亮起来。这个机制比在 Click 里写 if 判断要干净，而且 WPF 把“按钮可用性”和“业务逻辑是否允许执行”合成了一个来源。

示例里登录命令会用到 RelayCommand——一个通用的 ICommand 实现。为什么叫 Relay？因为它把执行逻辑转发给外部传入的委托，一个类到处复用。命令的 CanExecute 由委托决定，CommandManager 在界面交互时会定期重新查询 CanExecute，所以输入框一变化，按钮状态也会跟着刷。

到这里原理就够用了：ViewModel 负责状态和行为，属性变化通过 INotifyPropertyChanged 通知界面，按钮操作通过 ICommand 转发到 ViewModel。接下来进入这份示例实际的代码结构。

3. 从空目录到跑通登录：分层结构、XAML 绑定与 ViewModel 落地

这一章直接对照示例代码讲落地。先说明一下示例的项目结构，再分别看 XAML 和 ViewModel 的写法，最后说入口怎么把它们接起来。

3.1 项目结构与分层：照着建目录就能对上号

这份登录窗口示例的项目结构是典型的 MVVM 分层，我一般建议新项目也照这个骨架搭：

LoginSample/ ├─ App.xaml ├─ App.xaml.cs ├─ Models/ │ └─ UserModel.cs ├─ ViewModels/ │ ├─ ViewModelBase.cs │ ├─ LoginViewModel.cs │ └─ MainViewModel.cs ├─ Views/ │ ├─ LoginView.xaml │ ├─ LoginView.xaml.cs │ ├─ MainView.xaml │ └─ MainView.xaml.cs ├─ Services/ │ ├─ IAuthService.cs │ ├─ AuthService.cs │ └─ NavigationService.cs └─ Helpers/ ├─ RelayCommand.cs └─ PasswordBoxHelper.cs

文件职责对照表：

Model 层这份示例里只有一个用户实体，字段也很单纯：用户名、显示名、登录时间。真正的项目里还可以加角色、权限、令牌之类，但登录窗口示例不需要承载这么多。

3.2 登录窗口 XAML：把输入框和按钮全部交给绑定

LoginView 的 XAML 是这份示例的视图核心。布局是常见的居中卡片：两个输入框、一排错误提示、一个登录按钮和一个记住我复选框。绑定部分长这样：

<Window x:Class="LoginSample.Views.LoginView" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:helpers="clr-namespace:LoginSample.Helpers" Title="登录" Height="420" Width="360" WindowStartupLocation="CenterScreen" ResizeMode="NoResize"> <Grid Margin="30"> <Grid.RowDefinitions> <RowDefinition Height="Auto"/> <RowDefinition Height="Auto"/> <RowDefinition Height="Auto"/> <RowDefinition Height="Auto"/> <RowDefinition Height="Auto"/> <RowDefinition Height="Auto"/> </Grid.RowDefinitions> <TextBlock Text="用户登录" FontSize="20" FontWeight="Bold" Margin="0,0,0,20"/> <StackPanel Grid.Row="1" Margin="0,0,0,12"> <TextBlock Text="用户名" Margin="0,0,0,4"/> <TextBox x:Name="UserNameBox" Text="{Binding UserName, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}" Padding="6" Height="30"/> </StackPanel> <StackPanel Grid.Row="2" Margin="0,0,0,12"> <TextBlock Text="密码" Margin="0,0,0,4"/> <PasswordBox x:Name="PasswordBox" helpers:PasswordBoxHelper.BoundPassword="{Binding Password, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}" Padding="6" Height="30"/> </StackPanel> <CheckBox Grid.Row="3" Content="记住我" IsChecked="{Binding RememberMe, Mode=TwoWay}" Margin="0,0,0,12"/> <TextBlock Grid.Row="4" Text="{Binding ErrorMessage}" Foreground="#C42B1C" TextWrapping="Wrap" Visibility="{Binding HasError, Converter={StaticResource BoolToVisibilityConverter}}" Margin="0,0,0,12"/> <Button Grid.Row="5" Content="登录" Height="36" Command="{Binding LoginCommand}" IsDefault="True"/> </Grid> </Window>

逻辑说明：UserName 和 RememberMe 是普通绑定，UpdateSourceTrigger=PropertyChanged 让输入值实时同步到 ViewModel。PasswordBox 本身不能直接绑定，这里通过 PasswordBoxHelper 附加属性桥接，下面章节会专门拆这个坑。ErrorMessage 的显示用了 Visibility 转换器，把 bool 转成 Visible/Collapsed，有错误才显示红字。Button 的 Command 直接绑到 LoginCommand，IsDefault=True 让回车键也能触发登录。

参数说明：ResizeMode=NoResize 是因为登录窗口固定大小更省事，真实项目可视情况放开。WindowStartupLocation=CenterScreen 保证窗口居中。Visibility 绑定需要先在资源里声明 BooleanToVisibilityConverter，示例在 App.xaml 里注册。

3.3 LoginViewModel：状态、校验与登录流程

LoginViewModel 属于这份示例的“大脑”，所有界面状态和交互逻辑都在这。完整实现是：

public class LoginViewModel : ViewModelBase { private readonly IAuthService _authService; private string _userName = string.Empty; private string _password = string.Empty; private bool _rememberMe; private bool _isBusy; private string _errorMessage = string.Empty; public string UserName { get => _userName; set { if (SetProperty(ref _userName, value)) { OnPropertyChanged(nameof(HasError)); LoginCommand.RaiseCanExecuteChanged(); } } } public string Password { get => _password; set { if (SetProperty(ref _password, value)) { OnPropertyChanged(nameof(HasError)); LoginCommand.RaiseCanExecuteChanged(); } } } public bool RememberMe { get => _rememberMe; set => SetProperty(ref _rememberMe, value); } public bool IsBusy { get => _isBusy; set => SetProperty(ref _isBusy, value); } public string ErrorMessage { get => _errorMessage; set { if (SetProperty(ref _errorMessage, value)) { OnPropertyChanged(nameof(HasError)); } } } public bool HasError => !string.IsNullOrEmpty(_errorMessage); public RelayCommand LoginCommand { get; } public LoginViewModel(IAuthService authService) { _authService = authService; LoginCommand = new RelayCommand( execute: async () => await LoginAsync(), canExecute: () => CanLogin()); } private bool CanLogin() { return !string.IsNullOrWhiteSpace(UserName) && !string.IsNullOrEmpty(Password) && !IsBusy; } private async Task LoginAsync() { IsBusy = true; ErrorMessage = string.Empty; LoginCommand.RaiseCanExecuteChanged(); try { var result = await _authService.LoginAsync(UserName, Password); if (result.Success) { var mainViewModel = new MainViewModel(result.User); ShowMainWindow(mainViewModel); } else { ErrorMessage = result.ErrorMessage; } } catch (Exception ex) { ErrorMessage = $"登录失败：{ex.Message}"; } finally { IsBusy = false; LoginCommand.RaiseCanExecuteChanged(); } } private void ShowMainWindow(MainViewModel mainViewModel) { var window = new MainView { DataContext = mainViewModel }; Application.Current.MainWindow = window; window.Show(); Application.Current.Windows[0]?.Close(); } }

逻辑说明：CanLogin 要求用户名非空、密码非空、当前不在登录中，三个条件满足才允许点击。登录执行时先把 IsBusy 置 true 并清空旧错误，按钮在登录期间自动禁用，避免重复提交。调用服务用 await，UI 线程不会被阻塞。成功后新建 MainViewModel 并切到主窗口，失败则把错误信息填进 ErrorMessage 属性，让界面红字显示。finally 里恢复 IsBusy，保证任何情况下登录中标记都会被复位。

参数说明：LoginAsync 是私有异步方法而非 async void，是因为它由 RelayCommand 内部包装执行，命令执行器会负责异常处理。直接返回 Task 的命令实现在示例里做了 await，避免 async void 的异常逃逸。

3.4 启动入口：App.xaml 里把 View 和 ViewModel 接起来

示例的 App.xaml 里除了资源声明，还必须处理启动窗口。传统写法是 StartupUri="Views/LoginView.xaml"，但这样 DataContext 就得在 LoginView 的构造函数里手动 new，违背分层意图。示例用的是覆写 OnStartup：

public partial class App : Application { protected override void OnStartup(StartupEventArgs e) { base.OnStartup(e); var authService = new AuthService(); var loginViewModel = new LoginViewModel(authService); var loginWindow = new LoginView { DataContext = loginViewModel }; MainWindow = loginWindow; loginWindow.Show(); } }

逻辑说明：程序启动时先组装服务实例，再创建 LoginViewModel，最后把 ViewModel 赋给 LoginView 的 DataContext。这个写法叫手动组合根，在小项目里足够清晰，也方便后面替换成依赖注入容器。MainWindow 指定为登录窗口，主窗口登录成功后再接管。

4. 命令与密码框：登录按钮的 CanExecute、异步等待和附加属性实现

这一章解决登录示例里最容易被卡住的两个点：命令怎么写才能真正控制按钮状态，以及 PasswordBox 怎么绕过“不能绑定”的限制。

4.1 RelayCommand 的完整实现：从 ICommand 到带 CanExecute 的版本

登录示例里的 RelayCommand 和网上常见的简短版不太一样，它多了一个 RaiseCanExecuteChanged 方法，专门解决“输入框变化后按钮没有及时亮起”的问题。实现如下：

public class RelayCommand : ICommand { private readonly Action _execute; private readonly Func<bool>? _canExecute; private readonly bool _useCommandManager; private readonly object _locker = new object(); public RelayCommand(Action execute, Func<bool>? canExecute = null, bool useCommandManager = true) { _execute = execute ?? throw new ArgumentNullException(nameof(execute)); _canExecute = canExecute; _useCommandManager = useCommandManager; } public bool CanExecute(object? parameter) { return _canExecute?.Invoke() ?? true; } public void Execute(object? parameter) { _execute(); } public event EventHandler? CanExecuteChanged; public void RaiseCanExecuteChanged() { if (_useCommandManager) { CommandManager.InvalidateRequerySuggested(); } else { CanExecuteChanged?.Invoke(this, EventArgs.Empty); } } }

逻辑说明：构造函数接收两个委托——执行逻辑和可用性判断。CanExecute 直接调用外部传入的委托，这样按钮的可用性完全由 ViewModel 里 CanLogin 决定。RaiseCanExecuteChanged 做了双路处理：默认走 CommandManager.InvalidateRequerySuggested，让 WPF 在所有界面元素上下次重查时刷新；如果某些场景不需要 CommandManager 的全局轮询，可以关掉开关直接触发事件。

参数说明：useCommandManager 参数默认 true。登录窗口里我建议保留默认值，因为 CommandManager 在每次键盘鼠标交互后都会自动重查 CanExecute，配合 ViewModel 里手动调用 RaiseCanExecuteChanged，按钮状态几乎实时。如果项目按钮特别多，可以考虑关掉全局重查，仅在明确时机触发事件，减少无谓调用。

4.2 异步登录：await 别把 UI 卡死，也别丢了异常

登录肯定会调远程接口或数据库，这就引入异步。最容易踩的是两种写法：一种是全程同步调用，登录时界面卡死；另一种是 async void，异常直接吞进线程池，界面啥也不提示。

示例里 RelayCommand 的 execute 委托是 Action，没法直接 await。处理方式是在 ViewModel 的 execute 委托里写 async lambda，让它被包装成 async void 执行。这样写有一个隐患：如果登录方法内部没 catch，异常会从 async void 里直接抛到 UI 线程，程序崩溃。示例里用 try/catch/finally 兜住了所有分支，这个兜底不能省。

LoginCommand = new RelayCommand( execute: async () => { IsBusy = true; ErrorMessage = string.Empty; LoginCommand.RaiseCanExecuteChanged(); try { var auth = await _authService.LoginAsync(UserName, Password); if (auth.Success) { await Task.Delay(300); // 模拟跳转前的短暂过渡 ShowMainWindow(...); } else { ErrorMessage = auth.ErrorMessage; } } catch (Exception ex) { ErrorMessage = $"登录失败：{ex.Message}"; } finally { IsBusy = false; LoginCommand.RaiseCanExecuteChanged(); } }, canExecute: () => !IsBusy && !string.IsNullOrWhiteSpace(UserName) && !string.IsNullOrEmpty(Password));

逻辑说明：await 之前的代码在 UI 线程执行，所以 IsBusy=true 后的按钮禁用立刻生效。await 之后的代码默认回到 UI 线程执行——这是 WPF 的 SynchronizationContext 在起作用，不需要手动 Dispatcher.Invoke。登录期间 IsBusy=true，CanExecute 返回 false，按钮置灰，用户点一百次也只会触发一次请求。

参数说明：Task.Delay(300) 是示例里模拟网络延迟用的，真实项目删除。如果你改造成真实 HTTP 调用，建议给 HttpClient 设置超时时间，避免服务器端挂起导致界面永远停在登录中状态。auth.ErrorMessage 是服务返回的业务错误（用户名不存在、密码错误），与 catch 里的系统异常分开显示，这个区分在排错时很有用。

4.3 PasswordBox 不让绑：附加属性这个小轮子怎么造

PasswordBox 的 Password 属性不是依赖属性，控件设计了明确的“防止程序读取密码”策略，所以 Text="{Binding Password}" 这种写法是无效的。网上最常见的解法是附加属性，在 PasswordChanged 事件里把控件值转给 ViewModel。示例里 PasswordBoxHelper 长这样：

public static class PasswordBoxHelper { public static readonly DependencyProperty BoundPasswordProperty = DependencyProperty.RegisterAttached( "BoundPassword", typeof(string), typeof(PasswordBoxHelper), new FrameworkPropertyMetadata(string.Empty, FrameworkPropertyMetadataOptions.BindsTwoWayByDefault, OnBoundPasswordChanged)); public static string GetBoundPassword(DependencyObject obj) { return (string)obj.GetValue(BoundPasswordProperty); } public static void SetBoundPassword(DependencyObject obj, string value) { obj.SetValue(BoundPasswordProperty, value); } private static void OnBoundPasswordChanged(DependencyObject d, DependencyPropertyChangedEventArgs e) { if (d is not PasswordBox passwordBox) return; passwordBox.PasswordChanged -= OnPasswordChanged; if (!Equals(passwordBox.Password, e.NewValue)) { passwordBox.Password = e.NewValue?.ToString() ?? string.Empty; } passwordBox.PasswordChanged += OnPasswordChanged; } private static void OnPasswordChanged(object sender, RoutedEventArgs e) { if (sender is PasswordBox passwordBox) { SetBoundPassword(passwordBox, passwordBox.Password); } } }

逻辑说明：附加属性的名称是 BoundPassword，注册时用 BindsTwoWayByDefault 标志。当 ViewModel 的 Password 值变化时，OnBoundPasswordChanged 会尝试写回 PasswordBox；用户在界面输入时，PasswordChanged 事件把新值写回附加属性，从而同步到 ViewModel。

参数说明：OnBoundPasswordChanged 里先移除再挂回事件，目的是防止“程序赋值引发 PasswordChanged 事件，又把值写回 ViewModel”这个死循环。注意实际赋值场景只在初始化和清空时触发，用户输入过程中 ViewModel 不会反向写控件，因为此时两者值一致。示例里登录成功后建议把 Password 置空并清空 PasswordBox，避免密码残留在控件里。

这种解法有一个安全上的边界：明文密码存进了 ViewModel 字符串属性，内存里会有隐私数据残留。示例是教学性质所以这样处理，真实项目建议使用 SecureString 或者干脆只传递登录请求、不让密码进入 ViewModel 属性。

5. 避坑与排查：绑定失效、界面不刷新、密码取不到值的五类高频问题

运行这份登录示例时容易踩的就那几个坑，基本都能在半小时内定位。下面按“现象 → 原因 → 解决”的方式逐个过一遍。

5.1 绑定没生效：界面上的东西一动不动

现象：窗口能打开，但输入框是空的，错误信息也不显示，按钮一直是置灰状态。

原因：最常见的是 DataContext 没赋值。App.xaml 里用了 StartupUri 但没在构造函数里给 DataContext；或者把 DataContext 写在了 LoginView 的 XAML 里，但路径写错，比如把 LoginViewModel 写成了 MainViewModel。其次是绑定路径拼写错误，XAML 里写的是 UserNanme，ViewModel 里却是 UserName，这类问题编译期不报错。

解决：先看输出窗口，绑定时 WPF 会打印 BindingExpression path error 这类消息，照着属性名核对。再确认窗口构造函数里有没有 DataContext = new LoginViewModel(...) 或者启动时有没有赋值。最后把窗口的 d:DataContext 加上，设计时就能看到绑定是否生效。

提示：在 LoginView 构造函数里写 DataContext = new LoginViewModel(...) 会破坏可替换性，建议只在调试时临时使用，跑通后改回组合根的写法。

5.2 登录成功后只看到关窗，进程却还挂在任务管理器

现象：点登录按钮，登录窗口关了，主窗口也弹出来了，但任务管理器里进程还在；或者主窗口没弹出来，进程一直后台挂起。

原因：登录窗口被 Close 之后，Application.Current.MainWindow 还是指向那个已关闭的窗口，WPF 默认在所有窗口关闭时退出进程。如果你用 ShutdownMode="OnExplicitShutdown" 又没手动 Shutdown，进程就变成幽灵进程。示例里的跳转方式没有显式 Shutdown，导致登录窗关了、主窗口虽然出现，但主窗口关掉后进程还挂。

解决：登录成功切到主窗口时，把主窗口设为 Application.Current.MainWindow，并显式退出当前窗口的 Show 循环。示例代码里先赋值 MainWindow 再 Close 旧窗口，理论上能避免问题；如果还出问题，就把 App.xaml 里的 ShutdownMode 设成 OnMainWindowClose，确保主窗口一关进程就退出。

5.3 异步登录后界面上跑了半天，最后还是崩了

现象：点登录按钮后界面倒是没卡死，但几秒后程序突然崩掉，或者登录成功后界面没反应，任务管理器里看到异常日志。

原因：async void 命令执行函数里没有兜底 catch，异常抛到 SynchronizationContext 之后直接变成未处理异常。另一个原因是等异步返回后界面线程已经切换了，代码里又用了 Dispatcher 重复跳转，导致无效操作。

解决：命令执行函数内包完整的 try/catch/finally，确保所有异常路径都有处理。await 之后直接操作 UI 属性没问题，不要手动 new Thread 或 Dispatcher.Invoke。如果真要处理超时，用 CancellationTokenSource 配合 Task.WhenAny，超时后取消登录任务并提示用户重试。

5.4 密码框密码取不到：Password 根本不是依赖属性

现象：用户名能取到，密码却一直是空字符串；或者输入密码时程序崩溃，提示循环引用或绑定错误。

原因：PasswordBox 的 Password 属性不是依赖属性，也没有实现 INotifyPropertyChanged 的绑定支持。直接用 Text="{Binding Password}" 会静默失败，这是 WPF 里出了名的坑。有些资料让用户改用 TextBox 代替 PasswordBox，这会让密码明文显示在输入框里，不建议。

解决：用附加属性桥接，按上一章 PasswordBoxHelper 的写法接上。附加属性的 SetBoundPassword 里写回控件时要避免引起 PasswordChanged 连锁反应，否则会陷入循环赋值的死循环。如果出现“每次输入一个字符就闪退”，基本就是事件重入导致递归，检查事件移除/挂回的先后顺序。

5.5 CanExecute 不刷新：按钮该禁用还亮着

现象：用户名输入了、密码也输入了，登录按钮依然是置灰状态；或者登录执行期间按钮没有禁用，用户能重复点击。

原因：CommandManager 的 RequerySuggested 触发时机是交互动作后，但 ViewModel 属性变化不会自动触发重查。CanExecute 依赖的 IsBusy、UserName、Password 都是属性变化后需要手动通知命令刷新按钮状态，忘了调用 RaiseCanExecuteChanged 按钮就一直保持旧状态。

解决：在 ViewModel 里所有影响 CanExecute 的属性 setter 里调用 LoginCommand.RaiseCanExecuteChanged()。这是示例代码做了但在迁移时常被砍掉的一步。IsBusy 的 setter 也要通知，否则登录期间按钮不会禁用。测试方法很简单：登录执行中快速连点按钮，控制台只会输出一次登录请求日志，说明命令门控生效。

6. 验证登录逻辑：用单元测试和接口抽象锁住行为

这套示例跑通之后，剩下两件事能让它更耐用：把登录逻辑交给单元测试，以及用接口隔离真实服务。我的习惯是先把行为锁住，再谈重构。

6.1 用一段不依赖框架的测试锁住登录行为

没有引入测试框架的示例也可以用手写断言的方式验证核心逻辑。做法是给 IAuthService 写一个固定返回失败/成功的桩实现，然后断言 ViewModel 状态变化：

public class StubAuthService : IAuthService { private readonly bool _success; private readonly string _errorMessage; public StubAuthService(bool success, string errorMessage) { _success = success; _errorMessage = errorMessage; } public Task<AuthResult> LoginAsync(string userName, string password) { return Task.FromResult(new AuthResult(_success, _errorMessage, null)); } } // 验证失败场景 var vm = new LoginViewModel(new StubAuthService(false, "用户名或密码错误")); vm.UserName = "admin"; vm.Password = "wrong"; await vm.LoginCommand.ExecuteAsync(); // 示例中可包装为 Task 的命令方法 Debug.Assert(vm.HasError == true); Debug.Assert(vm.ErrorMessage == "用户名或密码错误");

逻辑说明：桩服务固定返回失败结果，直接验证 ViewModel 对错误路径的处理——有没有把 ErrorMessage 正确设置、HasError 有没有跟着变。这比打开界面手点更可靠，回归测试也能自动跑。

参数说明：示例中 RelayCommand 的 Execute 是同步包装的 async void，测试场景需要给 RelayCommand 增加一个 Task 版本的 ExecuteAsync 方法，或者在测试里直接调用 ViewModel 的 LoginAsync 私有方法（需要用反射，不推荐）。完整示例资源里提供了命令的 Task 版本实现，这是为了测试特意保留的。

6.2 把登录服务抽象成接口：换真实后端时只动一层

登录窗口最大的耦合点是 IAuthService。示例里只做了模拟登录，真正接后端时你会改 AuthService 的实现，而不是动 ViewModel。接口定义就三个成员：

public interface IAuthService { Task<AuthResult> LoginAsync(string userName, string password); } public class AuthResult { public bool Success { get; } public string ErrorMessage { get; } public UserModel? User { get; } public AuthResult(bool success, string errorMessage, UserModel? user) { Success = success; ErrorMessage = errorMessage; User = user; } }

逻辑说明：LoginAsync 接收用户名和密码，统一返回 AuthResult——成功时带用户实体，失败时带错误信息。ViewModel 不关心服务内部是查数据库还是调 Web API，只消费结果。换实现时新建一个 HttpAuthService 实现同一个接口，修改 App.xaml.cs 的组合根即可。

从那以后我每次搭 MVVM 登录窗口都强制走一遍这套流程：先写 ViewModel 和接口，再写 XAML 绑定，最后才接启动入口。密码框的附加属性、CanExecute 的手动刷新、异步异常兜底这三件事，每次都要重新确认一遍，不是代码难，是太容易在迁移时悄悄丢掉。希望这套示例和这些踩坑记录帮到你，少走我走过的弯路。

本文还有配套的精品资源，点击获取