maui-theming

.NET MAUI 主题设置

选择适合你的方案

方案	最适合	局限性
AppThemeBinding	根据操作系统自动切换浅色／深色主题——代码最少	仅支持两种主题（浅色 + 深色）
ResourceDictionary swap	自定义品牌主题、超过两种主题、用户偏好	需要更多设置，必须在所有地方使用 DynamicResource
两者结合	自动响应操作系统 + 自定义主题颜色	灵活性最高，但也最复杂

关键注意事项

Android：必须设置 ConfigChanges.UiMode

MainActivity 必须包含 ConfigChanges.UiMode，否则主题变更事件不会触发，Activity 会重启，而不是处理主题变更：

[Activity(Theme = "@style/Maui.SplashTheme",
          MainLauncher = true,
          ConfigurationChanges = ConfigChanges.ScreenSize
                               | ConfigChanges.Orientation
                               | ConfigChanges.UiMode  // ← Required for theme detection
                               | ConfigChanges.ScreenLayout
                               | ConfigChanges.SmallestScreenSize
                               | ConfigChanges.Density)]
public class MainActivity : MauiAppCompatActivity { }

如果没有 UiMode，在 Android 设置中切换深色模式会导致整个 Activity 重启——导航状态会丢失，用户也会以为应用崩溃了。

运行时无法切换 CSS 主题

MAUI 支持 CSS 样式，但无法动态切换基于 CSS 的主题。运行时切换请使用 ResourceDictionary 主题设置。

DynamicResource 与 StaticResource

使用 ResourceDictionary 切换主题时，必须使用 DynamicResource：

<Label TextColor="{DynamicResource PrimaryTextColor}" />


<Label TextColor="{StaticResource PrimaryTextColor}" />

快速参考

• 操作系统浅色／深色主题 → AppThemeBinding 标记扩展
• C# 中的主题颜色 → SetAppThemeColor()、SetAppTheme<T>()
• 读取操作系统主题 → Application.Current.RequestedTheme
• 强制设置主题 → Application.Current.UserAppTheme = AppTheme.Dark
• 主题变更 → RequestedThemeChanged 事件
• 自定义切换 → 在 MergedDictionaries 中替换 ResourceDictionary
• 运行时绑定 → DynamicResource（而不是 StaticResource）