1. 为什么我们需要模块化从“一锅炖”到“乐高积木”大家好我是老张一个在WPF和智能硬件领域摸爬滚打了十多年的老码农。今天想和大家聊聊一个让很多WPF开发者又爱又恨的话题如何构建一个真正“能长大”的应用程序。回想我早期做项目一个典型的WPF应用是什么样子一个庞大的解决方案里面塞满了各种窗口、用户控件、业务逻辑类所有的代码都挤在一起。主窗口的代码文件动辄几千行想改个按钮功能得在一堆事件处理程序里翻半天。更头疼的是当业务需求变化想加个新功能或者把某个功能独立出来给另一个项目用那简直是牵一发而动全身改得心惊胆战。这种“一锅炖”式的架构我们称之为“单体应用”。它在项目初期确实简单直接但随着功能迭代维护成本会指数级上升最终变成一个没人敢动的“屎山”。那么理想的架构应该是什么样的呢我觉得可以把它想象成玩乐高积木。每个独立的功能模块就像一块块标准接口的乐高积木。主程序只是一个“底板”和“说明书”负责把这些积木拼装起来。今天你想拼个汽车就把轮子、车身的积木装上明天想改成飞船就把轮子模块卸了装上推进器和机翼模块。整个过程清晰、灵活而且不会因为改动一个部件而把整个模型搞垮。WPFPrism这套组合拳就是帮我们实现“乐高式”开发的利器。Prism是微软官方推出的一个用于构建松耦合、可维护、可测试的XAML应用程序的框架。它不是一个全新的UI框架而是建立在WPF或WinUI、Xamarin.Forms等之上的“架构指南”和“工具箱”。它的核心思想就是模块化和依赖注入。通过Prism我们可以把应用拆分成多个独立的、可以动态加载的模块每个模块只关心自己的那部分功能模块之间通过定义好的接口进行通信而不是直接互相引用。这样一来应用的扩展性、可维护性和团队协作效率都会得到质的提升。2. 迈出第一步创建你的第一个Prism项目光说不练假把式咱们直接上手。我会带你从零开始一步步搭建一个具备模块化能力的Prism项目骨架。这个过程就像盖房子先打地基地基打好了后面往上垒砖加模块就轻松了。2.1 项目初始化与结构规划首先打开Visual Studio我用的2022其他版本也大同小异新建一个WPF应用项目。这里有个小选择用传统的.NET Framework还是新的.NET 6/7/8如果你的项目有遗留依赖或者特定要求用.NET Framework没问题。但我更推荐使用**.NET 6或更高版本**的WPF应用模板它能享受到跨平台潜力、更好的性能和更现代的依赖注入支持。我们给项目起个名比如PrismModularAppDemo。项目创建好后你会看到一个经典的MainWindow.xaml和App.xaml。先别急着写代码我们要对项目结构做一个重要的规划。在解决方案资源管理器里右键点击项目新建几个文件夹Views存放所有的视图View也就是XAML文件比如窗口、用户控件。ViewModels存放所有的视图模型ViewModel这是Prism MVVM模式的核心负责视图的展示逻辑。Models存放业务模型和数据实体类。Services存放各种服务类比如数据访问、网络通信、日志等。Modules这个文件夹先建好后面我们会把各个功能模块放在这里或者作为模块项目的引用目录。现在把自动生成的MainWindow.xaml和MainWindow.xaml.cs一起拖到Views文件夹里。移动后VS会提示你是否要更新所有引用点“是”。但为了保险起见我们手动检查两个地方打开App.xaml文件找到StartupUri属性把它从StartupUriMainWindow.xaml修改为StartupUriViews/MainWindow.xaml。打开Views/MainWindow.xaml文件找到根标签里的x:Class属性把它从x:ClassPrismModularAppDemo.MainWindow修改为x:ClassPrismModularAppDemo.Views.MainWindow。这一步操作看似简单却是关注点分离的良好开端。视图和视图模型分开放结构一目了然。2.2 引入Prism框架安装与基础配置接下来就是请出我们的主角——Prism框架。我们通过NuGet包管理器来安装。右键点击项目选择“管理NuGet程序包”。在浏览标签页中搜索“Prism.Unity”。注意Prism支持多种依赖注入容器比如Unity、DryIoc、Autofac等。Prism.Unity包就包含了Prism核心库和Unity容器的集成。对于新手我推荐从Unity开始它的概念相对直观。如果你熟悉其他容器也可以选择对应的包如Prism.DryIoc。找到Prism.Unity包作者是Brian Lagunas点击安装。这会自动安装一系列依赖包包括Prism的核心库Prism.Core和Unity容器。安装完成后我们首先来体验一下Prism带来的第一个便利自动的ViewModel绑定。传统WPF MVVM中我们需要在View的后台代码或XAML里手动设置DataContext。Prism简化了这个过程。在ViewModels文件夹中新建一个类命名为MainWindowViewModel。让它继承Prism.Mvvm.BindableBase这个类它提供了属性变更通知INotifyPropertyChanged的快捷实现。using Prism.Mvvm; namespace PrismModularAppDemo.ViewModels { public class MainWindowViewModel : BindableBase { private string _title 我的第一个Prism模块化应用; public string Title { get { return _title; } set { SetProperty(ref _title, value); } } public MainWindowViewModel() { // 这里可以初始化一些数据 } } }然后打开Views/MainWindow.xaml文件。在Window标签里添加Prism的命名空间引用并设置一个特殊的附加属性来实现自动绑定。Window x:ClassPrismModularAppDemo.Views.MainWindow xmlnshttp://schemas.microsoft.com/winfx/2006/xaml/presentation xmlns:xhttp://schemas.microsoft.com/winfx/2006/xaml xmlns:prismhttp://prismlibrary.com/ prism:ViewModelLocator.AutoWireViewModelTrue Title{Binding Title} Height450 Width800 Grid TextBlock Text{Binding Title} HorizontalAlignmentCenter VerticalAlignmentCenter FontSize24/ /Grid /Window关键就在prism:ViewModelLocator.AutoWireViewModelTrue这一行。Prism的视图模型定位器ViewModelLocator会遵循一个命名约定自动去寻找与当前ViewMainWindow对应的ViewModelMainWindowViewModel并且把它设置为View的DataContext。这个约定就是为什么我们之前要把View和ViewModel分开放到对应文件夹的原因。现在直接运行程序你会看到窗口标题和中间的文本都显示为“我的第一个Prism模块化应用”。这说明ViewModel已经成功绑定并工作了我们并没有在任何地方写this.DataContext new MainWindowViewModel();这就是约定优于配置的魅力也是依赖注入开始起作用的地方。3. 核心改造让应用“模块化”起来前面我们只是用上了Prism的MVVM绑定这已经很方便了但还没触及模块化的核心。接下来我们要对启动流程进行“大手术”把普通的WPF应用彻底改造成一个支持动态加载模块的Prism应用。3.1 重构应用启动类继承PrismApplication这是最关键的一步。默认的WPF应用入口是App.xaml和它的后台代码App.xaml.cs它继承自Application类。Prism要求我们使用它提供的PrismApplication类作为启动基类。首先打开App.xaml把Application改成prism:PrismApplication并引入Prism命名空间。prism:PrismApplication x:ClassPrismModularAppDemo.App xmlnshttp://schemas.microsoft.com/winfx/2006/xaml/presentation xmlns:xhttp://schemas.microsoft.com/winfx/2006/xaml xmlns:prismhttp://prismlibrary.com/ Application.Resources /Application.Resources /prism:PrismApplication然后打开App.xaml.cs文件。把类的继承从Application改为PrismApplication。using Prism.Unity; using System.Windows; namespace PrismModularAppDemo { public partial class App : PrismApplication // 继承PrismApplication { // 原有的StartupUri配置已经不需要了可以删除App.xaml中的StartupUri } }一保存你会发现代码报错了。因为PrismApplication是一个抽象类它要求我们实现几个核心的方法。点击类名App下的红色波浪线按AltEnter或点击小灯泡选择“实现抽象类”。VS会自动生成三个方法CreateShell()、RegisterTypes()和ConfigureModuleCatalog()。3.2 实现抽象方法搭建模块化骨架我们来逐一填充这些方法。1. CreateShell() - 创建应用的主壳ShellShell可以理解为应用程序的主容器窗口它定义了应用的总体布局结构比如顶部菜单、底部状态栏、左侧导航栏和中间的内容区域。在这里我们直接使用之前创建的MainWindow作为Shell。protected override Window CreateShell() { // 使用容器来解析MainWindow而不是直接new。 // 这样MainWindow及其依赖如它的ViewModel都会被依赖注入容器管理。 return Container.ResolveViews.MainWindow(); }注意这里用的是Container.ResolveViews.MainWindow()而不是new Views.MainWindow()。这是依赖注入的核心对象不由我们直接创建而是向“容器”索取。容器负责创建对象并自动注入它所依赖的其他对象比如MainWindowViewModel。2. RegisterTypes() - 注册类型到依赖注入容器这个方法是我们向IoC控制反转容器注册各种类型的地方。哪些类型需要注册呢主要是那些接口和它们的实现类以及一些需要容器管理的单例或共享实例。在我们这个初始阶段可能还没有很多服务但我们可以先把视图模型注册一下虽然Prism的AutoWireViewModel通常能搞定View和ViewModel的绑定但显式注册也是一个好习惯特别是当ViewModel有构造函数依赖时。protected override void RegisterTypes(IContainerRegistry containerRegistry) { // 注册MainWindowViewModel当需要MainWindowViewModel实例时容器会提供它。 // 使用PerRequest或Transient取决于你的需求对于View的ViewModel通常Transient即可。 containerRegistry.RegisterViewModels.MainWindowViewModel(); // 未来我们会在这里注册更多服务例如 // containerRegistry.RegisterIDataService, DataService(); // containerRegistry.RegisterSingletonILogger, FileLogger(); }3. ConfigureModuleCatalog() - 配置模块目录这是模块化的心脏。模块目录IModuleCatalog管理着应用中所有模块的信息模块有哪些、它们在哪里、应该按什么顺序初始化。在这个方法里我们告诉Prism去哪里发现和加载我们的模块。初期我们可以先添加一个内联的、直接引用程序集的模块。后面我们会升级为从目录动态加载。protected override void ConfigureModuleCatalog(IModuleCatalog moduleCatalog) { base.ConfigureModuleCatalog(moduleCatalog); // 方式一直接添加一个模块类型要求该模块所在程序集已被主程序引用 // moduleCatalog.AddModuleModuleA.ModuleAModule(); // 方式二通过类型名和所在程序集名称添加更灵活 // moduleCatalog.AddModule(typeof(ModuleA.ModuleAModule).Name, typeof(ModuleA.ModuleAModule).Assembly.FullName); // 我们现在还没有创建模块所以先注释掉。下一章我们会创建第一个模块并在这里添加。 }完成以上步骤后记得删除App.xaml中之前设置的StartupUriViews/MainWindow.xaml属性因为现在主窗口是由CreateShell()方法创建并显示的。现在再次运行程序应用应该能正常启动并显示MainWindow。看起来和之前没什么不同但内在的引擎已经彻底更换了。我们的应用已经从一辆“焊接死的汽车”变成了一个拥有标准接口的“底盘”随时可以按上各种功能“模块”。4. 创建你的第一个功能模块地基和骨架都有了现在我们来造第一块“乐高积木”——一个独立的功能模块。假设我们要为一个客户管理系统添加一个“客户管理”模块。4.1 模块项目的创建与结构在解决方案中我们不再把所有代码都塞进启动项目。而是为“客户管理”功能单独创建一个项目。在解决方案上右键 - 添加 - 新建项目。选择“类库(.NET Framework)”或“类库(.NET Standard/.NET Core)”。我强烈建议选择.NET Standard 2.0类库。.NET Standard是一个API规范能被.NET Framework、.NET Core/.NET 5等多种.NET实现引用兼容性最好是模块化开发的理想选择。给项目起名为CustomerModule。在这个新类库项目中同样引用Prism.Unity的NuGet包。因为模块也需要使用Prism的模块化接口和依赖注入。在CustomerModule项目中创建类似的文件夹结构Views,ViewModels,Services等。一个Prism模块的核心是一个实现了IModule接口的类。这个类通常以Module结尾例如CustomerModule。4.2 实现IModule接口模块的入口点在CustomerModule项目的根目录或者单独建一个Infrastructure文件夹创建一个类CustomerModule.cs。using Prism.Ioc; using Prism.Modularity; using Prism.Regions; using CustomerModule.Views; using System.Windows.Controls; namespace CustomerModule { public class CustomerModule : IModule { private readonly IRegionManager _regionManager; // 通过构造函数注入IRegionManager用于向Shell中的区域注册视图 public CustomerModule(IRegionManager regionManager) { _regionManager regionManager; } public void OnInitialized(IContainerProvider containerProvider) { // 模块初始化时将客户列表视图注册到Shell中名为“MainContentRegion”的区域。 // 假设你的ShellMainWindow里有一个ContentControl其RegionNameMainContentRegion _regionManager.RegisterViewWithRegion(MainContentRegion, typeof(CustomerListView)); } public void RegisterTypes(IContainerRegistry containerRegistry) { // 在这里注册本模块特有的类型到容器中 // 例如注册本模块的视图、服务等 containerRegistry.RegisterForNavigationCustomerListView(); // 注册视图用于导航 containerRegistry.RegisterICustomerService, CustomerService(); // 注册服务 } } }这个CustomerModule类就是模块的“大脑”。OnInitialized方法在模块被加载后调用这里我们通常做视图注册到区域Region的操作。RegisterTypes方法和主程序中的类似用于向容器注册本模块提供的服务。4.3 定义模块视图与区域Region区域Region是Prism中一个极其强大的概念。你可以把它理解为Shell主窗口中预留的、可以被动态替换内容的“占位符”。比如主窗口左边是导航栏区域NavigationRegion中间是主内容区域MainContentRegion。首先我们需要修改主程序ShellMainWindow.xaml定义区域。我们使用Prism的附加属性来标记一个控件为区域。Window ... Grid Grid.RowDefinitions RowDefinition HeightAuto/ RowDefinition Height*/ /Grid.RowDefinitions !-- 顶部菜单栏 -- Menu Grid.Row0 MenuItem Header模块 MenuItem Header加载客户模块 Command{Binding LoadCustomerModuleCommand}/ /MenuItem /Menu !-- 主内容区域这里被定义为一个Region -- ContentControl Grid.Row1 prism:RegionManager.RegionNameMainContentRegion/ /Grid /Window在CustomerModule项目中我们创建一个简单的视图CustomerListView.xaml放在Views文件夹和对应的CustomerListViewModel。!-- CustomerListView.xaml -- UserControl x:ClassCustomerModule.Views.CustomerListView ... StackPanel TextBlock Text客户列表 FontSize18 Margin10/ ListBox ItemsSource{Binding Customers} DisplayMemberPathName Height200/ Button Content添加测试客户 Command{Binding AddTestCustomerCommand} Margin10/ /StackPanel /UserControl// CustomerListViewModel.cs using Prism.Commands; using Prism.Mvvm; using System.Collections.ObjectModel; namespace CustomerModule.ViewModels { public class CustomerListViewModel : BindableBase { public ObservableCollectionCustomer Customers { get; set; } new ObservableCollectionCustomer(); public DelegateCommand AddTestCustomerCommand { get; private set; } public CustomerListViewModel() { AddTestCustomerCommand new DelegateCommand(AddTestCustomer); // 初始化一些测试数据 Customers.Add(new Customer { Id 1, Name 张三 }); Customers.Add(new Customer { Id 2, Name 李四 }); } private void AddTestCustomer() { Customers.Add(new Customer { Id Customers.Count 1, Name $测试客户{Customers.Count 1} }); } } public class Customer { public int Id { get; set; } public string Name { get; set; } } }4.4 在主程序中加载模块最后一步回到主程序PrismModularAppDemo我们需要告诉它去哪里找这个CustomerModule。首先在主项目中添加对CustomerModule类库项目的项目引用。这是最简单直接的模块加载方式模块与主程序一起编译。然后修改主程序App.xaml.cs中的ConfigureModuleCatalog方法protected override void ConfigureModuleCatalog(IModuleCatalog moduleCatalog) { base.ConfigureModuleCatalog(moduleCatalog); // 添加CustomerModule并指定其初始化模式为WhenAvailable默认主程序启动时加载 // 也可以设置为OnDemand在需要时手动加载 moduleCatalog.AddModuleCustomerModule.CustomerModule(); }现在运行主程序。由于我们在模块的OnInitialized中将CustomerListView注册到了MainContentRegion所以程序一启动主内容区域就会自动显示客户列表视图。点击“添加测试客户”按钮列表会增加新项目。至此你已经成功创建并加载了第一个Prism模块这个模块完全独立于主程序它有自己的视图、视图模型、模型甚至服务。主程序除了通过项目引用知道它的存在在代码层面几乎没有耦合。你可以独立地开发、测试、甚至替换这个模块只要它遵守约定的接口比如注册到哪个区域。5. 进阶实战动态加载与模块通信直接引用项目的方式适合紧密集成的模块。但更酷的模式是动态加载主程序在运行时从一个指定的目录如Modules去发现和加载模块的DLL文件。这样你甚至可以在不重新发布主程序的情况下通过增删DLL文件来扩展或移除功能。5.1 配置目录发现模块修改主程序的ConfigureModuleCatalog方法改用目录扫描方式protected override void ConfigureModuleCatalog(IModuleCatalog moduleCatalog) { base.ConfigureModuleCatalog(moduleCatalog); // 获取模块目录的路径假设在应用程序根目录下的Modules文件夹 string modulePath Path.Combine(AppDomain.CurrentDomain.BaseDirectory, Modules); // 使用DirectoryModuleCatalog来扫描指定目录下的所有模块 if (Directory.Exists(modulePath)) { var directoryCatalog new DirectoryModuleCatalog { ModulePath modulePath }; // 这里通常需要将directoryCatalog中的模块合并到主catalog中 // 但更常见的做法是直接使用DirectoryModuleCatalog作为主catalog。 // 我们可以重写CreateModuleCatalog方法来返回一个DirectoryModuleCatalog。 } }更常见的做法是重写CreateModuleCatalog()方法直接返回一个配置好的目录模块目录。protected override IModuleCatalog CreateModuleCatalog() { // 返回一个配置了模块路径的DirectoryModuleCatalog string modulePath Path.Combine(AppDomain.CurrentDomain.BaseDirectory, Modules); return new DirectoryModuleCatalog() { ModulePath modulePath }; }使用这种方式你需要将编译好的CustomerModule.dll及其依赖如Prism相关DLL复制到主程序运行目录下的Modules文件夹中。主程序启动时会自动扫描并加载该目录下的所有有效模块。5.2 模块间通信解耦的艺术模块之间不应该直接互相引用否则就失去了模块化的意义。Prism提供了几种优雅的通信机制事件聚合器EventAggregator这是最常用、最解耦的方式。一个模块发布Publish一个事件其他模块订阅Subscribe这个事件。发布者和订阅者彼此不知道对方的存在。// 在模块A中定义事件 public class CustomerAddedEvent : PubSubEventCustomer { } // 模块A发布事件 _eventAggregator.GetEventCustomerAddedEvent().Publish(newCustomer); // 模块B订阅事件 _eventAggregator.GetEventCustomerAddedEvent().Subscribe(c { // 处理新客户添加的逻辑比如刷新自己的列表 RefreshCustomerList(); }, ThreadOption.UIThread); // 指定在UI线程执行共享服务Shared Services将公共功能抽象成接口放在一个公共的类库如Infrastructure中。所有模块都引用这个公共库并通过依赖注入获取服务的实现。主程序负责注册这个服务的具体实现。区域上下文Region Context当多个视图被注入到同一个区域时可以通过区域上下文来传递数据。在实际项目中我强烈推荐使用事件聚合器来处理跨模块的业务通知。它最大限度地降低了模块间的耦合度。5.3 导航与视图切换Prism提供了强大的导航服务可以让你在不同的视图之间切换并传递参数。这比直接操作Region的Views集合更高级、更规范。在ViewModel中你可以注入IRegionManager或INavigationService来进行导航。// 使用IRegionManager进行区域内的视图导航更底层 _regionManager.RequestNavigate(MainContentRegion, CustomerDetailView, parameters); // 使用INavigationService进行导航更高级与平台无关性更好 _navigationService.NavigateAsync(CustomerDetailView, parameters);导航的目标“CustomerDetailView”是一个字符串标识它需要在模块的RegisterTypes中通过RegisterForNavigation注册。containerRegistry.RegisterForNavigationCustomerDetailView, CustomerDetailViewModel(CustomerDetailView);踩过的坑导航时一定要确保目标视图和视图模型已经正确注册到容器中并且导航参数的类型是简单的、可序列化的类型复杂对象最好传递一个ID然后在目标视图的初始化过程中再去查询完整数据。6. 项目组织与最佳实践建议经过前面的实战一个模块化应用的雏形已经出来了。但要把它用到真正的企业级项目里还需要一些工程化的考量。6.1 解决方案与项目结构一个中等规模的Prism模块化应用解决方案结构可能如下MyEnterpriseApp.sln ├── MyEnterpriseApp.Shell (WPF应用启动项目) │ ├── Views (Shell的视图如MainWindow) │ ├── ViewModels │ ├── App.xaml/.cs (PrismApplication入口) │ └── Modules 文件夹 (存放动态加载的模块DLL) ├── MyEnterpriseApp.Infrastructure (.NET Standard 类库) │ ├── Interfaces (公共接口如 ILogger, IDataService) │ ├── Models (公共数据模型) │ ├── Events (公共事件使用EventAggregator) │ └── Constants (公共常量如RegionNames) ├── ModuleA (.NET Standard 类库) │ ├── ModuleAModule.cs (实现IModule) │ ├── Views │ ├── ViewModels │ └── Services ├── ModuleB (.NET Standard 类库) └── (其他模块...)关键点Shell项目尽可能“薄”它只负责启动、加载模块、提供主界面框架。具体的业务功能全部放在模块里。基础设施Infrastructure项目这是所有模块和Shell的“公约数”。里面放大家都要用的接口、事件、模型、工具类。任何模块都不应该直接引用另一个模块但都可以引用Infrastructure。模块项目独立每个模块都是一个完整的、可以独立编译和测试的功能单元。6.2 依赖注入与生命周期管理Prism的依赖注入容器是你应用的核心“管家”。要善用它接口与实现分离始终针对接口进行注册和注入。containerRegistry.RegisterIMyService, MyService()。生命周期Transient每次请求都创建一个新实例。这是默认的适用于无状态的轻量级服务。Singleton整个应用生命周期内只有一个实例。适用于配置服务、缓存服务等。Scoped在某些容器中支持如DryIoc可以创建某个范围内的单例在WPF中通常用RegisterScoped或特定区域内的单例。构造函数注入这是首选的方式。确保你的类尤其是ViewModel的依赖都通过构造函数传入容器会自动解析。6.3 调试与部署技巧模块加载失败最常见的错误是模块DLL或其依赖项如特定版本的Prism没有放在正确的位置。使用DirectoryModuleCatalog时打开Prism的日志输出Prism.Logging可以帮助诊断加载问题。设计时支持在XAML设计器中如果ViewModel是通过容器解析的设计时可能看不到数据。可以在ViewModel的构造函数中通过IsInDesignMode属性来提供设计时数据。部署对于动态加载你需要一个清晰的部署脚本将主程序Shell、基础设施库、各个模块的DLL以及它们各自的依赖正确地复制到输出目录的相应位置如主目录和Modules子目录。可以使用构建后事件或专门的打包工具如Inno Setup, WiX来处理。从我个人的经验来看第一次搭建Prism模块化架构会花一些时间可能会觉得比直接写“一锅炖”的代码更繁琐。但一旦项目规模超过3个主要功能点或者有超过2个开发者参与模块化带来的优势就会迅速体现出来并行开发互不干扰、功能复用简单、定位bug范围小、测试可以针对模块进行。它迫使你思考代码的边界和职责这本身就是对代码质量的一次巨大提升。