简介这是一套基于WPF ModernUI构建的通用界面框架源码面向需要快速搭建现代化桌面应用的开发者尤其适合希望以较低配置成本实现插件化功能集成的中高级WPF使用者。框架支持三级菜单、皮肤更换与字体调整并提供将自定义功能注册到页面的扩展方式配合OSGi.NET插件机制可组织较复杂的模块化界面对通用后台管理、工具软件等场景有较强参考价值。压缩包共253个文件约3.49MB以C#源码和XAML界面文件为主同时包含DLL、XML配置、项目文件、资源图片与少量可执行文件覆盖界面控件、外观管理、插件模型及示例配置等层面便于直接运行、拆解和二次开发。已有4443人学习适合借鉴其ModernUI控件实现、菜单导航、换肤与模块注册思路并在此基础上搭建自己的WPF应用框架。1. 漂亮的 WPF 界面框架不是换皮先看它把哪些脏活收进了壳里很多 WPF 界面框架看起来漂亮真正落地时却卡在主题资源、导航壳和插件加载这三件事上。这套资源把 ModernUI 风格的主题字典、Shell 窗口、导航服务和插件契约收进一个可运行工程不是单纯换皮。它适合需要快速搭后台工具、设备管理端、内部运营台的人新手能先跑示例页熟手能直接看插件边界和资源分层。你要判断的不是“好不好看”而是它有没有把脏活收进壳里让你改主题时不碰业务、加页面时不改主窗口。如果这套壳的Themes、Contracts、Plugins三层分得清楚后面接业务页面和第三方插件会省很多返工分不清楚再漂亮的界面也只是个演示窗口。2. ModernUI 壳的骨架资源字典、控件样式与导航容器怎么分层2.1 先判断这套壳是“主题库拼装”还是“自绘控件体系”拿到一套 WPF 界面框架我一般先不急着跑而是看它的 XAML 分布。主题库拼装的壳通常大量合并第三方资源字典控件样式以BasedOn为主自绘控件体系会在ControlTemplate里重写按钮、列表框、滚动条和窗口边框。两者的维护成本不一样前者升级主题库时容易被动后者改一处颜色可能牵动十几个模板。判断这一步不是为了评判优劣而是决定你后面改样式时该找哪个入口。可以用 PowerShell 先扫一遍目录重点看Themes、Controls、Views三个位置的文件分布。不要一上来就全量打开先看命名和层级能快速判断这套壳有没有把基础色、控件样式、页面布局分开。Get-ChildItem -Recurse -Depth 2 | Where-Object { $_.Extension -in .xaml,.cs,.csproj } | Select-Object FullName这段命令只做目录侦察-Depth 2控制递归深度避免解决方案一大就输出刷屏。看结果时重点盯三个信号Themes下是否有独立的颜色字典和控件字典Controls下是否有大量自定义ControlTemplateViews下页面是否直接写死颜色和边距。如果页面里到处是Background#FFFFFF说明这套壳的 Design Token 没收口后面换主题会翻车。提示先看App.xaml的MergedDictionaries它基本暴露了这套 WPF 界面框架的样式入口。入口越集中后面越好改。2.2 把资源字典按“基础色、控件样式、页面级资源”拆开ModernUI 风格的壳最怕资源字典互相依赖成一团。合格的分层是基础色和字体只定义值不引用控件控件样式只引用基础资源不引用页面资源页面级资源只服务当前页面。这样你换品牌色时只动第一层按钮、卡片、导航栏会自动跟着变。很多“漂亮但难维护”的 WPF 界面问题就出在控件模板里直接写了颜色值主题切换时只有一半控件变色。资源合并顺序要固定基础色在前控件样式在后布局资源最后。StaticResource在 XAML 加载时解析顺序错了会直接抛找不到资源DynamicResource在运行时查找适合需要切换主题的画刷。我的习惯是颜色、字体、圆角这类会变的资源统一用DynamicResource尺寸和结构类资源可以用StaticResource。Application.Resources ResourceDictionary ResourceDictionary.MergedDictionaries ResourceDictionary Sourcepack://application:,,,/Themes/Colors.xaml / ResourceDictionary Sourcepack://application:,,,/Themes/Controls.xaml / ResourceDictionary Sourcepack://application:,,,/Themes/Layout.xaml / /ResourceDictionary.MergedDictionaries /ResourceDictionary /Application.Resources这段App.xaml的关键在pack://application:,,,/这个 URI。三段分别表示应用资源、当前程序集和资源路径少了斜杠或程序集名写错设计器可能正常、运行时直接白屏。Colors.xaml必须先于Controls.xaml因为控件样式里的DynamicResource要在运行时找得到 key。Layout.xaml放页面间距、卡片圆角这类布局值放在最后是为了让页面级覆盖有更高的查找优先级。注意如果资源字典放在独立类库pack://application:,,,/后面的程序集名不能省。很多“设计时好看、运行时样式全丢”的问题都是 URI 写成了相对路径。2.3 导航容器只做三件事区域、路由、返回栈WPF 界面框架的 Shell 不需要什么都管。导航容器只做三件事提供一个内容区域、把页面 Key 映射到页面实例、维护返回栈。菜单、工具栏、状态栏是 Shell 的外围不要和导航逻辑耦合。常见做法是用ContentControl作为导航宿主配合DataTemplate把 ViewModel 映射到 View页面自己不new Window也不直接操作主窗口。这样插件注册进来的页面和内置页面走同一条导航链路后面加权限过滤、页面缓存、返回逻辑都有地方挂。下面这个导航服务是最小可用版本Register负责登记页面工厂Navigate负责切换内容GoBack负责回退。页面工厂用Funcobject而不是直接传实例是为了让页面在真正打开时才创建避免启动时把所有页面都初始化一遍。public interface INavigationService { void Register(string pageKey, Funcobject factory); void Navigate(string pageKey); bool GoBack(); } public sealed class NavigationService : INavigationService { private readonly ContentControl _host; private readonly Dictionarystring, Funcobject _factories new Dictionarystring, Funcobject(StringComparer.OrdinalIgnoreCase); private readonly Stackobject _backStack new Stackobject(); public NavigationService(ContentControl host) { _host host; } public void Register(string pageKey, Funcobject factory) { _factories[pageKey] factory; } public void Navigate(string pageKey) { if (!_factories.TryGetValue(pageKey, out var factory)) return; if (_host.Content ! null) _backStack.Push(_host.Content); _host.Content factory(); } public bool GoBack() { if (_backStack.Count 0) return false; _host.Content _backStack.Pop(); return true; } }_host是 Shell 里的ContentControl导航服务不关心它放在窗口哪一侧。pageKey建议用模块名.页面名避免内置页面和插件页面撞键。_backStack只存页面对象不存参数如果页面需要恢复状态参数要单独放到页面上下文里。StringComparer.OrdinalIgnoreCase让页面 Key 不区分大小写减少插件注册时的低级错误。XAML 侧只需要一个宿主和一组DataTemplateContentControl x:NamePageHost / DataTemplate DataType{x:Type vm:HomeViewModel} views:HomeView / /DataTemplateContentControl.Content赋成 ViewModel 时WPF 会按DataType找对应的DataTemplate赋成 View 时直接显示。两种方式都能用但团队里最好统一一种。我的习惯是导航服务只认页面对象ViewModel 到 View 的映射交给DataTemplate这样插件返回 ViewModel 也能接入不会把 Shell 绑死在某个视图类型上。3. 把插件接进 WPF 界面接口契约、发现、加载与卸载边界3.1 插件契约先定薄页面、菜单、导航入口三件套插件化最容易犯的错是让插件直接引用 Shell 的具体窗口和导航类。这样插件一多Shell 改一个属性所有插件都要重编译。正确做法是单独放一个契约程序集里面只有接口、元数据和少量 DTOShell 和插件都引用它但插件不引用 Shell 实现。契约要薄插件能登记导航入口、能拿到一个受控的上下文、能声明自己的元数据就够了。文件读写、数据库连接、权限判断这些能力通过上下文接口暴露不要直接塞进插件。下面这组接口是常见的最小契约。IPlugin是插件入口PluginMetadata描述插件身份IPluginContext是 Shell 给插件的受控能力。AddNavigation的viewFactory返回页面对象Shell 负责把它放进导航宿主插件不碰主窗口。public interface IPlugin { PluginMetadata Metadata { get; } void Register(IPluginContext context); } public sealed class PluginMetadata { public string Id { get; set; } public string DisplayName { get; set; } public int Order { get; set; } public string[] Permissions { get; set; } } public interface IPluginContext { void AddNavigation(string pageKey, string title, Funcobject viewFactory); }Id用来做插件唯一标识建议带上命名空间前缀DisplayName是菜单显示名Order控制菜单排序空值给默认值不要留 0 导致所有插件挤在一起Permissions是给后续权限过滤留的口不要在插件里自己判断角色。viewFactory延迟创建页面插件加载时只注册工厂不初始化页面启动速度会好很多。提示契约程序集不要被插件目录自带一份。Shell 和插件必须引用同一个契约程序集否则IPlugin类型对不上加载时会出现“明明实现了接口却转不过去”的玄学问题。3.2 插件发现与加载目录扫描加 AssemblyLoadContext 隔离插件发现不要全盘扫描。固定一个插件根目录按子目录或*.dll扫描每个插件独立加载上下文。目标框架支持AssemblyLoadContext时优先用它做隔离老 .NET Framework 项目常见做法是 MEF但 MEF 的目录扫描和依赖解析边界不一样不要两边代码硬套。这里按支持AssemblyLoadContext的工程写核心思路是共享契约交给默认上下文插件私有依赖留在插件上下文。public sealed class PluginLoadContext : AssemblyLoadContext { private readonly AssemblyDependencyResolver _resolver; private readonly HashSetstring _shared; public PluginLoadContext(string pluginPath, IEnumerablestring sharedAssemblies) : base(isCollectible: true) { _resolver new AssemblyDependencyResolver(pluginPath); _shared new HashSetstring(sharedAssemblies, StringComparer.OrdinalIgnoreCase); } protected override Assembly Load(AssemblyName assemblyName) { if (_shared.Contains(assemblyName.Name)) return null; // 共享契约交回默认上下文避免类型重复 var path _resolver.ResolveAssemblyToPath(assemblyName); return path null ? null : LoadFromAssemblyPath(path); } }AssemblyDependencyResolver的基准路径是插件 DLL 的完整路径它依赖插件旁边的.deps.json解析依赖。_shared里放契约程序集和 Shell 公共程序集名命中后返回null让默认加载上下文处理这样插件和 Shell 拿到的是同一个类型。isCollectible: true表示支持卸载但卸载不是免费的插件注册的静态事件、后台线程、WPF 资源引用没清掉上下文就回收不了。血泪经验是先把加载跑通再谈卸载不要一上来就追求热插拔。扫描加载时单个插件失败不能拖垮 Shell。下面这段代码按 DLL 逐个加载异常只记日志插件入口类型用IsAssignableFrom判断public IReadOnlyListIPlugin LoadFrom(string pluginRoot) { var result new ListIPlugin(); foreach (var dll in Directory.EnumerateFiles(pluginRoot, *.dll, SearchOption.AllDirectories)) { try { var context new PluginLoadContext(dll, new[] { Contracts, Shell }); var assembly context.LoadFromAssemblyPath(Path.GetFullPath(dll)); foreach (var type in assembly.GetTypes() .Where(t typeof(IPlugin).IsAssignableFrom(t) !t.IsAbstract)) { result.Add((IPlugin)Activator.CreateInstance(type)); } } catch (Exception ex) { Debug.WriteLine(${dll}: {ex.Message}); } } return result; }pluginRoot用绝对路径避免工作目录变化导致扫描不到。SearchOption.AllDirectories适合插件按子目录放的工程如果插件目录很大改成顶层扫描再按清单加载。GetTypes()可能抛ReflectionTypeLoadException生产环境要单独捕获并把LoaderExceptions记下来否则你只能看到一句“加载失败”没有后悔药。日志里至少记录 DLL 路径、插件 ID、异常类型后面排查依赖冲突全靠它。3.3 插件页面注册到 ModernUI 导航菜单项和路由的合并插件加载完不要立刻刷新菜单。先把所有插件的导航项收集起来按Order和标题排序再去重合并最后一次性更新菜单。每加载一个插件就刷新一次 UI插件一多会看到菜单闪烁启动也慢。去重键用插件ID.页面Key不要只用页面标题标题会重复Key 不会。public sealed class NavigationRegistry { private readonly ListNavigationItem _items new ListNavigationItem(); private readonly HashSetstring _keys new HashSetstring(StringComparer.OrdinalIgnoreCase); public void Add(string key, string title, int order, Funcobject factory) { if (!_keys.Add(key)) return; // 冲突先到先得同时写诊断日志 _items.Add(new NavigationItem(key, title, order, factory)); } public IReadOnlyListNavigationItem Build() { return _items .OrderBy(i i.Order) .ThenBy(i i.Title, StringComparer.CurrentCulture) .ToList(); } }NavigationItem里存 Key、标题、排序和页面工厂Shell 只消费Build()的结果。Order默认给 1000避免插件没填时排到最前面。ThenBy用当前区域文化排序中文菜单不会按拼音乱跳。注册时机放在 Shell 初始化之后、主窗口显示之前太早宿主还没创建太晚菜单已经绑定完都会出现“页面能打开但菜单没有”的尴尬。4. 视觉参数落地颜色、字体、圆角、阴影与动效的可维护写法4.1 先把“漂亮”拆成可调的 Design TokenModernUI 的漂亮不是靠某个按钮的渐变而是靠一套稳定的 Design Token品牌色、表面色、文字色、边框色、圆角、间距、字号、阴影。Token 不统一页面就会越写越花最后没人敢改。我的建议是先定一张小表只放最常用的十几项页面里只允许引用 Token不允许写十六进制颜色。下面这张表可以直接照着改成项目自己的值。Token建议值用在哪修改注意Brand.Brush#1F6FEB主按钮、选中态、链接换品牌色只改这一处Surface.Brush#FFFFFF卡片、面板背景暗色主题要提供对应值Text.Primary.Brush#1F2328标题、正文对比度至少 4.5:1Text.Secondary.Brush#656D76辅助说明不要用在关键操作上Card.CornerRadius8卡片、按钮、输入框统一圆角别混用 4 和 12Font.Size.Body14正文跟系统 DPI 一起测Space.Page16页面内边距和卡片间距保持倍数关系这张表的价值在于约束。比如圆角卡片用 8按钮也用 8输入框还用 8视觉上才像一个体系按钮 4、卡片 12、弹窗 16单看都行放一起就散。阴影同理要么统一用一层浅阴影要么统一用边框不要一半卡片有阴影一半没有。WPF 里阴影用DropShadowEffect会影响渲染性能列表项多的时候尽量用边框或背景色分层。4.2 用资源字典和附加属性收口不在页面里散写颜色资源字典里定义画刷、圆角、间距和字号页面和控件模板通过DynamicResource引用。这样换主题时只需要替换字典不用逐页改。下面这段是最小资源定义sys:Double需要引入System命名空间CornerRadius和Thickness直接作为资源使用。ResourceDictionary xmlnshttp://schemas.microsoft.com/winfx/2006/xaml/presentation xmlns:xhttp://schemas.microsoft.com/winfx/2006/xaml xmlns:sysclr-namespace:System;assemblymscorlib SolidColorBrush x:KeyBrand.Brush Color#1F6FEB / SolidColorBrush x:KeySurface.Brush Color#FFFFFF / SolidColorBrush x:KeyText.Primary.Brush Color#1F2328 / CornerRadius x:KeyCard.CornerRadius8/CornerRadius Thickness x:KeyCard.Padding16/Thickness sys:Double x:KeyFont.Size.Body14/sys:Double /ResourceDictionary命名用区域.用途.类型比如Brand.Brush、Text.Primary.Brush比BlueColor这种名字好维护。SolidColorBrush会被DynamicResource引用主题切换时替换字典里的画刷控件自动更新。CornerRadius和Thickness是值类型DynamicResource也能用但不要在模板里用TemplateBinding绑到不存在的属性上。控件样式里也要用DynamicResource不要只在页面里用。下面这个按钮样式把背景、圆角、内边距都收进模板Style x:KeyModernButton TargetTypeButton Setter PropertyBackground Value{DynamicResource Brand.Brush} / Setter PropertyForeground ValueWhite / Setter PropertyPadding Value14,8 / Setter PropertyBorderThickness Value0 / Setter PropertyTemplate Setter.Value ControlTemplate TargetTypeButton Border Background{TemplateBinding Background} CornerRadius{DynamicResource Card.CornerRadius} Padding{TemplateBinding Padding} ContentPresenter HorizontalAlignmentCenter VerticalAlignmentCenter / /Border /ControlTemplate /Setter.Value /Setter /StyleTemplateBinding把控件属性传进模板DynamicResource让圆角和背景跟随主题。很多人只在Setter里写DynamicResource模板里又写死#1F6FEB结果换主题时按钮背景变了、边框没变看起来像半成品。样式写完后页面里只写Style{StaticResource ModernButton}不要再补颜色。注意DropShadowEffect在大列表里很吃性能卡片阴影能用边框替代就用边框。动效也不要给每个列表项加滚动时会明显掉帧。4.3 动效只留三处页面切换、加载态、提示条WPF 界面框架的动效不需要多三处就够页面切换的淡入和轻微位移、加载态的旋转或进度条、提示条从边缘滑入。时长控制在 120 到 200 毫秒超过 300 毫秒用户会觉得卡。动画属性优先选Opacity和RenderTransform不要动Width、Height、Margin这类触发布局的属性。下面这个页面进入动画只动透明度和TranslateTransform.Y不会触发重新测量。Storyboard x:KeyPageEnter DoubleAnimation Storyboard.TargetPropertyOpacity From0 To1 Duration0:0:0.16 / DoubleAnimation Storyboard.TargetProperty(UIElement.RenderTransform).(TranslateTransform.Y) From8 To0 Duration0:0:0.16 DoubleAnimation.EasingFunction CubicEase EasingModeEaseOut / /DoubleAnimation.EasingFunction /DoubleAnimation /StoryboardDuration0:0:0.16是 160 毫秒From8是 8 像素位移按 DPI 缩放后仍然自然。CubicEase的EaseOut让动画收尾变慢比线性动画舒服。使用前要确保目标元素有RenderTransform并且RenderTransformOrigin设置合理否则位移方向会偏。页面切换动画只在导航宿主上跑一次不要在每个用户控件里各跑一套动效一多就变成干扰。5. 避坑与排查ModernUI 壳和插件化最容易翻车的 5 个点5.1 现象启动后样式全丢控件回到默认灰现象很典型设计器里 ModernUI 样式正常运行后按钮变成系统默认灰色圆角、颜色、字体全没了。原因通常有三个App.xaml的资源字典路径写错StartupUri直接打开了某个窗口绕过了App.xaml的资源合并资源字典放在类库pack://application:,,,/后面的程序集名漏了。解决时先看App.xaml有没有被正确编译成ApplicationDefinition再看输出目录里的资源文件是否存在。ResourceDictionary Sourcepack://application:,,,/Themes/Colors.xaml /pack://application:,,,/是应用资源的标准前缀后面跟程序集名和路径。当前程序集可以省略程序集名但独立类库不能省。改完路径后清理一次bin和objWPF 的资源编译缓存有时会让你怀疑人生。5.2 现象插件加载后主窗口卡死或启动变慢插件一多启动时同步扫描目录、同步加载所有 DLL、在插件构造函数里连数据库主窗口就会白屏几秒。原因不是 WPF 慢是 UI 线程被占住了。解决思路是把扫描和加载放到后台线程插件构造函数只做注册不做重活页面工厂保持懒加载等用户点菜单再创建页面。var plugins await Task.Run(() _loader.LoadFrom(pluginRoot)); foreach (var plugin in plugins) { plugin.Register(_pluginContext); }Task.Run只包住加载插件注册回到 UI 线程执行因为注册可能碰导航集合。如果插件注册本身很重再拆成“收集元数据”和“应用注册”两段。不要在后台线程直接改ObservableCollectionWPF 的集合绑定会抛跨线程异常。5.3 现象插件页面能打开但导航菜单不显示或重复页面能通过代码打开菜单却没有或者同一个插件出现两次。原因通常是注册时机晚于菜单绑定、插件 ID 冲突、Order没给默认值。解决时先把导航项收集到NavigationRegistry去重后再一次性Build()菜单只绑定最终结果。页面 Key 用插件ID.页面Key不要只用标题。if (!keys.Add(${plugin.Metadata.Id}.{pageKey})) { Debug.WriteLine($重复导航项{plugin.Metadata.Id}.{pageKey}); return; }去重时记录日志不要静默丢弃。重复项往往是插件复制了一份或者旧版本没删干净日志能帮你快速定位。5.4 现象切换主题后部分控件不跟着变换主题后主界面变了某些第三方控件、图表、弹窗还是旧颜色。原因是这些控件用了StaticResource或者在模板里写死了颜色或者第三方控件根本没有用DynamicResource。排查时先在页面里搜StaticResource和#把颜色引用换成DynamicResource第三方控件要看它的模板是否暴露了背景、前景属性没暴露就只能在外层包一层容器做适配。!-- 不跟随主题 -- Border Background{StaticResource Surface.Brush} / !-- 跟随主题 -- Border Background{DynamicResource Surface.Brush} /StaticResource在加载时解析一次DynamicResource在运行时查找。主题切换靠的是替换字典所以会变的资源必须用DynamicResource。但也不要全量替换结构类资源用StaticResource性能更好。5.5 现象发布后插件目录找不到或加载失败开发环境能加载发布后插件全部失败。原因常见于插件目录没有复制到输出、AssemblyDependencyResolver的基准路径不对、插件私有依赖和 Shell 依赖版本冲突。解决时先确认发布目录里插件 DLL 和.deps.json都在再在加载器里记录每个插件的解析路径和异常。共享契约程序集必须走默认上下文插件私有依赖留在插件上下文两者不要混。ItemGroup None IncludePlugins\**\*.* CopyToOutputDirectoryPreserveNewest / /ItemGroupCopyToOutputDirectory确保插件目录跟着输出。发布后先跑一次冷启动看日志里每个插件的加载耗时和失败原因。不要凭肉眼判断“应该没问题”插件加载的黑匣子只有日志能打开。6. 进阶验证插件隔离、启动诊断与发布前自检插件化跑通之后最容易忽略的是验证。我的习惯是给加载器加一段诊断日志记录每个插件的 DLL 路径、加载耗时、入口类型、注册的导航项数量。下面这段代码不复杂但能在发布前把大部分依赖冲突和重复注册暴露出来。var sw Stopwatch.StartNew(); var plugins _loader.LoadFrom(pluginRoot); foreach (var plugin in plugins) { var before sw.ElapsedMilliseconds; plugin.Register(_pluginContext); Debug.WriteLine($插件 {plugin.Metadata.Id} 注册耗时 {sw.ElapsedMilliseconds - before}ms); } Debug.WriteLine($插件总加载耗时 {sw.ElapsedMilliseconds}ms数量 {plugins.Count});Stopwatch放在加载前后能看出是扫描慢、加载慢还是注册慢。单个插件注册超过 200 毫秒就要查它是不是在构造函数里做了 IO。日志里不要只打“成功”要打插件 ID 和导航项数量重复注册和空注册一眼就能看出来。发布前我会跑一张自检表不靠记忆自检项通过标准失败先看冷启动主窗口 2 秒内可见插件是否同步加载主题切换按钮、卡片、导航栏同步变色是否用了StaticResource插件加载每个插件都有 ID 和导航项日志契约程序集是否重复导航去重同一页面 Key 只出现一次插件旧版本是否残留发布目录插件 DLL 和 deps 文件齐全csproj 复制配置这套 WPF 界面框架真正的价值不是让你少写几个按钮样式而是把主题、导航、插件三层的边界先划出来。边界清楚后面加页面和换主题都是局部改动边界不清楚每加一个插件都在赌。从那以后我每次接新插件都先跑一遍冷启动诊断不再凭肉眼判断“应该没问题”。希望帮到你。本文还有配套的精品资源点击获取
