MAUI 动态主题切换本质是“资源字典 + 主题状态监听 + DynamicResource 绑定”三者协同的结果。它不依赖第三方库,.NET MAUI 原生支持亮色(Light)、暗色(Dark)和跟随系统(Unspecified)三种模式,关键在于你如何组织资源、响应变化、避免卡顿。
主题资源要分文件、按需合并
把不同主题的样式拆成独立 XAML 文件,比如 LightTheme.xaml 和 DarkTheme.xaml,再在 App.xaml 中统一合并:
每个主题文件只放对应颜色、字体、样式,例如:<color x:key="BackgroundColor">#FFFFFF</color>(Light)和
<color x:key="BackgroundColor">#121212</color>(Dark) 在 App.xaml 的
<application.resources></application.resources>内使用
MergedDictionaries引入所有主题字典,不用手动删/加,MAUI 会根据当前主题自动启用匹配项 避免在资源字典里写
x:Scope="Dark"这类非标准写法——它不是 MAUI 官方机制,容易失效或干扰热重载
UI 元素必须用 DynamicResource
静态引用(
StaticResource)在加载时就锁定值,换主题不会更新;而
DynamicResource是运行时绑定,主题一变,所有控件自动刷新: 按钮背景:
BackgroundColor="{DynamicResource PrimaryColor}"
文字颜色:TextColor="{DynamicResource TextPrimaryColor}"
哪怕是一个 Frame的
Background或
Image的
Source,只要涉及主题变量,都得用
DynamicResource注意:不能对
DynamicResource做嵌套绑定,比如
{DynamicResource {x:Static local:MyKeys.TitleColor}} 是非法的
监听系统变化 + 支持手动切换
MAUI 自动读取系统设置,但用户也可能点按钮强制切主题。两者都要覆盖:
在 App.xaml.cs 构造函数中注册事件:RequestedThemeChanged += OnThemeChanged;在
OnThemeChanged方法里调用
Application.Current.UserAppTheme = newTheme;(这步触发资源重解析) 手动切换时,直接设
UserAppTheme即可,无需 reload 页面或重建资源字典 如果想让 Picker 或 Switch 控件联动主题,用
ObservableObject+
[ObservableProperty]绑定
UserAppTheme,属性变更自动同步
避免卡顿:预加载 + 缓存资源
频繁切换导致 UI 卡顿,通常是因为每次都在重复解析 XAML 资源。解决方法很直接:
在 MauiProgram.cs 中注册单例主题服务:builder.Services.AddSingleton<ithemeservice themeservice>();</ithemeservice>主题服务内部预加载 Light/Dark 字典并缓存为
ResourceDictionary实例,切换时直接替换
Application.Current.Resources.MergedDictionaries别在页面 OnAppearing 里反复 Merge 同一个字典,也别用代码动态 new ResourceDictionary 并 AddRange —— 这些都会触发全量重绘 图片、图标等资源建议用
MauiImage+
IconTintColorBehavior,颜色随主题自动适配,不用准备两套图
基本上就这些。不需要魔改平台层,也不用写一堆条件判断。结构清晰、资源分离、绑定正确、缓存到位,主题切换就是毫秒级响应。
