简介：这是一套基于 WPF 的 WMS 仓库管理系统示例源码，面向具备一定 C# 与 XAML 基础、希望深入理解 MVVM 落地方式的桌面开发学习者。项目采用 Stylet 框架组织 MVVM 结构，配合 MaterialDesign 实现界面样式，数据访问层使用 SqlSugar 操作 SqlServer2008，涵盖登录界面、主界面、左侧下拉菜单、DataGrid 查询展示等典型模块，适合作为企业级后台管理系统的入门参考。压缩包共 498 个文件，约 17.8MB，其中 140 个 cs 源码文件承载业务与视图模型逻辑，13 个 xaml 与 13 个 baml 对应界面布局，另有 67 个 dll、20 个 json 及若干 csproj、sln 等工程与依赖文件，结构完整可直接编译运行。目前已有 1072 人学习下载。通过该源码可掌握 Stylet 的依赖注入与窗口管理、MaterialDesign 控件定制、SqlSugar 增删改查封装以及登录与主界面导航的完整链路，便于快速搭建自己的 WMS 或后台管理项目骨架。
1. 从登录窗到主界面：WPF MVVM 在 WMS 仓库系统里到底怎么落地
很多做 WMS 仓库管理系统的团队，一开始都会掉进同一个坑：登录窗用事件驱动写，主界面用 Code-Behind 堆控件，等到要加权限、要换皮肤、要做多仓库切换时，整个项目已经改不动了。WPF 的 MVVM 不是学院派玩具，它在仓库系统这种「表单密集、权限复杂、状态多」的场景里，恰恰是最省心的架构选择。这篇笔记就围绕「登录 → 主界面」这条最短路径，把 WPF MVVM 在 WMS 里的工程化做法讲透：ViewModel 怎么组织、命令怎么绑定、登录态怎么传递、主界面的导航和权限怎么收口。适合正在用 WPF 做仓储、ERP、MES 这类桌面端的开发者，也适合从 WinForm 迁过来、被数据绑定和命令绕晕的同学。下面所有代码都是可复现的最小骨架，不依赖任何第三方 UI 库也能跑起来。
2. 登录模块的 MVVM 拆解：从密码框绑定到异步校验
登录看起来简单，但在 WMS 里它承担了三件事：身份认证、仓库/账套选择、登录态初始化。这三件事如果全塞进一个LoginWindow.xaml.cs，后面加个「记住上次仓库」都要改窗口代码。MVVM 的做法是把它们拆成 View（纯 XAML）、ViewModel（状态与命令）、Model/Service（认证与配置读写）。
2.1 为什么密码框不能直接双向绑定
WPF 的PasswordBox.Password属性出于安全考虑不是依赖属性，所以{Binding Password}这种写法在密码框上直接失效。新手最常见的翻车就是在这里：绑定了但永远拿不到值，调试半天以为是 DataContext 没设对。
常见做法有三种，我一般用「附加属性 + 命令参数」的组合。先定义一个附加属性把密码同步到 ViewModel：
// PasswordBoxHelper.cs using System.Windows; using System.Windows.Controls; public static class PasswordBoxHelper { // 附加属性：把 PasswordBox 的密码同步到 ViewModel 的绑定源 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) => (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 box) return; // 防止回写造成死循环 box.PasswordChanged -= OnPasswordChanged; if (box.Password != (string)e.NewValue) box.Password = (string)e.NewValue; box.PasswordChanged += OnPasswordChanged; } private static void OnPasswordChanged(object sender, RoutedEventArgs e) { var box = (PasswordBox)sender; SetBoundPassword(box, box.Password); } }逻辑说明：附加属性BoundPassword让 XAML 里可以写local:PasswordBoxHelper.BoundPassword="{Binding Password, Mode=TwoWay}"。OnBoundPasswordChanged里先解绑事件再赋值，是为了避免「ViewModel 改密码 → 触发 PasswordChanged → 又回写 ViewModel」这种循环。参数上BindsTwoWayByDefault保证默认双向，省得每个绑定都写 Mode。
XAML 侧这样用：
<PasswordBox local:PasswordBoxHelper.BoundPassword="{Binding Password, Mode=TwoWay}" Height="32" Margin="0,8" />提示：不要为了省事把密码明文存进 ViewModel 的普通属性然后序列化到配置文件，WMS 的登录信息一旦落盘就是安全事故。
2.2 LoginViewModel 的状态与命令设计
登录 ViewModel 要暴露的核心成员其实就几个：用户名、密码、仓库列表、选中的仓库、登录命令、是否正在登录。命令用ICommand实现，推荐自己写一个轻量RelayCommand，比引第三方库更可控。
// RelayCommand.cs using System; using System.Windows.Input; public class RelayCommand : ICommand { private readonly Action<object?> _execute; private readonly Predicate<object?>? _canExecute; public RelayCommand(Action<object?> execute, Predicate<object?>? canExecute = null) { _execute = execute ?? throw new ArgumentNullException(nameof(execute)); _canExecute = canExecute; } // CanExecuteChanged 挂到 CommandManager 上，按钮可用状态自动刷新 public event EventHandler? CanExecuteChanged { add => CommandManager.RequerySuggested += value; remove => CommandManager.RequerySuggested -= value; } public bool CanExecute(object? parameter) => _canExecute?.Invoke(parameter) ?? true; public void Execute(object? parameter) => _execute(parameter); }逻辑说明：把CanExecuteChanged委托给CommandManager.RequerySuggested，是 WPF 里最省事的做法——只要界面交互触发重询，按钮的禁用/启用就会自动更新，不用手动RaiseCanExecuteChanged。参数execute用object?是为了兼容带参命令，比如列表行里的「删除」按钮。
LoginViewModel 骨架：
public class LoginViewModel : INotifyPropertyChanged { private readonly IAuthService _authService; private string _userName = string.Empty; private string _password = string.Empty; private bool _isBusy; public string UserName { get => _userName; set { _userName = value; OnPropertyChanged(); } } public string Password { get => _password; set { _password = value; OnPropertyChanged(); } } public bool IsBusy { get => _isBusy; set { _isBusy = value; OnPropertyChanged(); } } public ObservableCollection<Warehouse> Warehouses { get; } = new(); public Warehouse? SelectedWarehouse { get; set; } public ICommand LoginCommand { get; } public LoginViewModel(IAuthService authService) { _authService = authService; LoginCommand = new RelayCommand(async _ => await LoginAsync(), _ => !IsBusy && !string.IsNullOrWhiteSpace(UserName)); } private async Task LoginAsync() { IsBusy = true; try { // 认证 + 拉取该账号可访问的仓库列表 var result = await _authService.AuthenticateAsync(UserName, Password, SelectedWarehouse?.Id); if (result.Success) LoginCompleted?.Invoke(this, result.Session); else ErrorMessage = result.Message; } finally { IsBusy = false; } } public event EventHandler<UserSession>? LoginCompleted; public event PropertyChangedEventHandler? PropertyChanged; private void OnPropertyChanged([CallerMemberName] string? name = null) => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(name)); }逻辑说明：LoginCommand的canExecute里判断!IsBusy，登录过程中按钮自动禁用，避免重复提交——这在仓库系统里很关键，重复登录可能触发多次会话初始化。LoginCompleted事件把UserSession抛给 View，由 View 决定是打开主窗口还是提示错误，ViewModel 不直接new MainWindow()，保持可测试。
参数说明：IAuthService是接口，真实项目里注入具体实现；UserSession里至少带UserId、UserName、WarehouseId、Permissions集合，后面主界面的权限控制全靠它。
2.3 登录成功后的窗口切换与登录态传递
登录窗关闭、主窗打开这个动作，放在 View 层做最干净。常见做法是在App.xaml.cs里控制启动流程，而不是在登录窗里直接Show主窗。
// App.xaml.cs 片段 protected override void OnStartup(StartupEventArgs e) { base.OnStartup(e); var loginVm = new LoginViewModel(new AuthService()); var loginWin = new LoginWindow { DataContext = loginVm }; loginVm.LoginCompleted += (_, session) => { var mainVm = new MainViewModel(session, new NavigationService()); var mainWin = new MainWindow { DataContext = mainVm }; mainWin.Show(); loginWin.Close(); // 先 Show 再 Close，避免应用因窗口数为 0 而退出 }; loginWin.Show(); }逻辑说明：ShutdownMode默认是OnLastWindowClose，如果先Close登录窗再Show主窗，中间会有一瞬间窗口数为 0，应用直接退出——这是很多人遇到的「登录成功后程序莫名关闭」的元凶。先Show主窗再Close登录窗就绕开了。参数上session通过构造函数注入 MainViewModel，比全局静态变量更利于单元测试。
3. 主界面布局与导航：把菜单、内容区、状态栏拆成可组合的 ViewModel
主界面是 WMS 的门面，左侧菜单、顶部工具栏、中间内容区、底部状态栏，四块区域各自独立又互相联动。MVVM 的难点不在布局，而在「菜单点击后内容区怎么换」「权限怎么控制菜单可见性」「状态栏怎么实时反映当前仓库」。
3.1 用 ContentControl + DataTemplate 做内容区导航
不要在主界面里塞一堆TabControl或者手动Visibility切换，那样每加一个模块就要改主界面 XAML。正确姿势是内容区放一个ContentControl，绑定到MainViewModel.CurrentView，再用DataTemplate把 ViewModel 类型映射到 View。
<!-- MainWindow.xaml 内容区 --> <ContentControl Content="{Binding CurrentView}" Grid.Column="1" Margin="8" /><!-- App.xaml 资源里注册映射 --> <Application.Resources> <DataTemplate DataType="{x:Type vm:InboundViewModel}"> <v:InboundView /> </DataTemplate> <DataTemplate DataType="{x:Type vm:OutboundViewModel}"> <v:OutboundView /> </DataTemplate> <DataTemplate DataType="{x:Type vm:StockQueryViewModel}"> <v:StockQueryView /> </DataTemplate> </Application.Resources>逻辑说明：ContentControl.Content拿到的是 ViewModel 对象，WPF 根据运行时类型去资源里找匹配的DataTemplate，找到就渲染对应 View。这样主界面完全不知道有哪些业务模块，新增模块只需加一个 DataTemplate 和一条菜单项。参数上DataType必须是具体 ViewModel 类型，不能写基类，否则所有模块都会渲染成同一个 View。
3.2 菜单项与权限：MenuItem 的 ItemsSource 绑定
WMS 的菜单必须按角色动态生成，仓管员看不到财务模块，管理员能看到全部。做法是把菜单抽象成MenuNode集合，权限过滤在 ViewModel 里完成。
public class MenuNode { public string Title { get; set; } = string.Empty; public string Icon { get; set; } = string.Empty; public Type? ViewModelType { get; set; } // 叶子节点才有 public List<MenuNode> Children { get; set; } = new(); public string? RequiredPermission { get; set; } }// MainViewModel 里构建菜单 private void BuildMenus(UserSession session) { var all = new List<MenuNode> { new() { Title = "入库管理", RequiredPermission = "Inbound.View", Children = { new() { Title = "收货登记", ViewModelType = typeof(InboundViewModel), RequiredPermission = "Inbound.Receive" } } }, new() { Title = "出库管理", RequiredPermission = "Outbound.View", Children = { new() { Title = "拣货发运", ViewModelType = typeof(OutboundViewModel), RequiredPermission = "Outbound.Pick" } } }, new() { Title = "库存查询", ViewModelType = typeof(StockQueryViewModel), RequiredPermission = "Stock.Query" } }; // 递归过滤：没有权限的节点直接剔除 Menus = new ObservableCollection<MenuNode>(Filter(all, session.Permissions)); } private static IEnumerable<MenuNode> Filter(IEnumerable<MenuNode> nodes, HashSet<string> perms) { foreach (var n in nodes) { if (n.RequiredPermission != null && !perms.Contains(n.RequiredPermission)) continue; n.Children = Filter(n.Children, perms).ToList(); yield return n; } }逻辑说明：Filter用递归 +yield return，父节点没权限时子节点自然不出现，父节点有权限但子节点全被过滤时，父节点会变成空菜单——实际项目里可以再加一条「Children 为空且无 ViewModelType 则剔除」的规则。参数RequiredPermission用字符串常量，建议集中在一个静态类里定义，避免拼写错误。
XAML 侧用HierarchicalDataTemplate渲染：
<TreeView ItemsSource="{Binding Menus}"> <TreeView.Resources> <HierarchicalDataTemplate DataType="{x:Type vm:MenuNode}" ItemsSource="{Binding Children}"> <TextBlock Text="{Binding Title}" Padding="4" /> </HierarchicalDataTemplate> </TreeView.Resources> <TreeView.ItemContainerStyle> <Style TargetType="TreeViewItem"> <Setter Property="IsExpanded" Value="True" /> </Style> </TreeView.ItemContainerStyle> </TreeView>3.3 状态栏与当前仓库的联动
状态栏要显示当前仓库、当前用户、在线状态。这些数据都来自UserSession，但仓库可能在主界面里被切换，所以MainViewModel要暴露一个CurrentWarehouse属性，状态栏绑定它。
private Warehouse _currentWarehouse; public Warehouse CurrentWarehouse { get => _currentWarehouse; set { if (_currentWarehouse == value) return; _currentWarehouse = value; OnPropertyChanged(); // 切换仓库后通知所有子模块刷新数据 EventAggregator.Publish(new WarehouseChangedEvent(value.Id)); } }逻辑说明：切换仓库时通过事件聚合器广播，各业务 ViewModel 订阅后重新加载数据。这里不直接调用子模块方法，是为了避免 MainViewModel 依赖所有子模块，保持单向依赖。参数WarehouseChangedEvent里带WarehouseId，订阅方按需过滤。
4. 避坑与排查：WPF MVVM 在 WMS 里最容易翻车的 5 个点
这一章全是血泪经验，每条都按「现象 → 原因 → 解决」写，遇到对应症状直接对号入座。
现象一：登录按钮点了没反应，命令不执行。原因通常是DataContext没设对，或者RelayCommand的CanExecute一直返回 false。排查时先在Execute里打断点，如果断点不进，检查 XAML 根节点有没有DataContext，或者按钮的Command绑定路径是否写错。另一个隐蔽原因是CanExecute里访问了未初始化的集合导致异常被吞掉，WPF 会静默把按钮置灰。解决：CanExecute里只做轻量判断，异常用 try-catch 包住并打日志。
现象二：主界面内容区切换后旧 View 不释放，内存持续上涨。原因是DataTemplate生成的 View 被 WPF 缓存，或者 ViewModel 订阅了事件聚合器但没取消订阅。解决：在 ViewModel 里实现IDisposable，导航离开时取消订阅；如果模块很重，考虑用ContentControl的ContentTemplateSelector手动控制缓存策略。参数上注意EventAggregator.Subscribe返回的 token 要保存，Dispose时Unsubscribe。
现象三：密码框绑定后，输入中文或粘贴时值不同步。原因是PasswordBoxHelper里OnBoundPasswordChanged的循环保护写得不严，粘贴触发多次PasswordChanged。解决：在OnPasswordChanged里加一个_isUpdating标志位，赋值期间直接 return。另外PasswordBox对输入法组合字符的处理有延迟，必要时监听TextCompositionManager事件。
现象四：菜单权限过滤后，父节点还在但子节点全没了，点开是空的。原因是Filter只判断了节点自身权限，没判断过滤后子节点是否为空。解决：在Filter里先递归处理Children，如果Children为空且ViewModelType为 null，就跳过该节点。参数上给MenuNode加一个IsLeaf => ViewModelType != null的只读属性，判断更清晰。
现象五：登录成功后主窗口一闪而过，程序退出。前面提过，根因是ShutdownMode和窗口关闭顺序。解决：App.OnStartup里先mainWin.Show()再loginWin.Close()；或者显式设置ShutdownMode = ShutdownMode.OnExplicitShutdown，在真正退出时调Application.Current.Shutdown()。后者更可控，但记得所有退出路径都要调，否则进程残留。
注意：以上五个问题里，前两个是架构层面的，后三个是细节层面的。架构问题越早定规矩越好，细节问题靠单元测试和日志兜底。
5. 进阶技巧：用依赖注入和设计时数据把主界面开发效率拉满
到这一步，登录和主界面已经能跑通了。但真实 WMS 项目里，ViewModel 会越来越多，构造函数参数会越来越长，手动new会变成灾难。我一般会引入一个轻量依赖注入容器，把 Service、ViewModel、窗口都注册进去，App.OnStartup只负责Resolve和Show。
// 用 Microsoft.Extensions.DependencyInjection 的注册片段 var services = new ServiceCollection(); services.AddSingleton<IAuthService, AuthService>(); services.AddSingleton<INavigationService, NavigationService>(); services.AddTransient<LoginViewModel>(); services.AddTransient<MainViewModel>(); services.AddTransient<InboundViewModel>(); services.AddTransient<OutboundViewModel>(); var provider = services.BuildServiceProvider();逻辑说明：AddSingleton用于无状态或全局共享的服务，AddTransient用于每次导航都要新实例的 ViewModel。参数上注意MainViewModel如果持有子 ViewModel，子 ViewModel 的注册生命周期要和导航策略匹配——每次切换都新建就用 Transient，想缓存就用 Singleton 加手动清理。
另一个提效手段是设计时数据。XAML 设计器默认拿不到运行时 DataContext，界面一片空白，调布局全靠猜。在 ViewModel 里加静态构造方法，配合d:DataContext就能在设计器里看到假数据：
<Window x:Class="Wms.MainWindow" xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" mc:Ignorable="d" d:DataContext="{d:DesignInstance vm:MainViewModel, IsDesignTimeCreatable=True}">逻辑说明：IsDesignTimeCreatable=True要求MainViewModel有无参构造函数，或者设计时能走通构造逻辑。我一般给 ViewModel 加一个DesignTimeMainViewModel子类，构造函数里塞假菜单和假仓库，只在设计器里生效，运行时用 DI 注入真实依赖。这样调主界面布局时不用每次启动整个应用，效率提升非常明显。
最后一个习惯：所有跨模块通信都走事件聚合器，不要用Application.Current.MainWindow去强转然后调方法。我早期项目里主界面直接((MainWindow)Application.Current.MainWindow).RefreshStock()，后来主窗口类型一改，全项目编译不过。改成事件后，模块之间只认事件类型，重构成本几乎为零。这个教训让我在后来的每个 WPF 项目里，第一件事就是定好事件契约。希望帮到你。
本文还有配套的精品资源，点击获取
