MAUI动态主题切换本质是资源字典+主题状态监听+DynamicResource绑定协同实现；原生支持亮色、暗色、跟随系统三种模式，需分文件组织主题资源、统一合并、使用DynamicResource绑定、监听RequestedThemeChanged事件并预加载缓存资源字典。
MAUI 动态主题切换本质是“资源字典 + 主题状态监听 + DynamicResource 绑定”三者协同的结果。它不依赖第三方库，.NET MAUI 原生支持亮色（Light）、暗色（Dark）和跟随系统（Unspecified）三种模式，关键在于你如何组织资源、响应变化、避免卡顿。
主题资源要分文件、按需合并
把不同主题的样式拆成独立 XAML 文件，比如 LightTheme.xaml 和 DarkTheme.xaml，再在 App.xaml 中统一合并：
- 每个主题文件只放对应颜色、字体、样式，例如：
#FFFFFF #121212 - 在 App.xaml 的
内使用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(); - 主题服务内部预加载 Light/Dark 字典并缓存为
ResourceDictionary实例，切换时直接替换Application.Current.Resources.MergedDictionaries - 别在页面 OnAppearing 里反复 Merge 同一个字典，也别用代码动态 new ResourceDictionary 并 AddRange —— 这些都会触发全量重绘
- 图片、图标等资源建议用
MauiImage+IconTintColorBehavior，颜色随主题自动适配，不用准备两套图
基本上就这些。不需要魔改平台层，也不用写一堆条件判断。结构清晰、资源分离、绑定正确、缓存到位，主题切换就是毫秒级响应。
