Avalonia集成Fluent主题需安装匹配版本的Avalonia.Themes.Fluent包,在App.xaml中通过或StyleInclude引入资源;支持运行时切换明暗模式、自定义AccentColor和CornerRadius;多主题共存需手动管理Styles集合。

Avalonia 使用 Fluent 主题非常简单,核心是通过 FluentTheme 控件和资源字典注入实现,主题切换则依赖动态替换 Styles 集合中的主题资源。
引入 Fluent 主题资源
在应用启动时(通常在 App.xaml 或 Program.cs 中),需将 Fluent 主题的样式资源加载进全局 Styles。Avalonia 11+ 推荐使用 FluentTheme 控件配合 FluentColors,但最直接的方式是引用预编译的 Fluent 资源字典:
- 确保已安装
Avalonia.Themes.FluentNuGet 包(版本需与 Avalonia 主版本匹配,如 Avalonia 11 对应Avalonia.Themes.Fluent 11.x) - 在
App.xaml的中添加:
或显式引用资源字典(兼容性更强):
运行时切换主题模式(Light/Dark)
Fluent 主题支持通过 FluentTheme.Mode 属性动态切换明暗模式。推荐做法是把 FluentTheme 实例放在根窗口或 App 级别,并绑定或手动更新其 Mode 属性:
- 在主窗口 XAML 中定义
FluentTheme并命名,例如: - 代码中切换:
Theme.Mode = ThemeMode.Dark; 或 Theme.Mode = ThemeMode.Light; - 若使用 MVVM,可将
Mode绑定到 ViewModel 的ThemeMode属性,并触发通知
自定义主题颜色(强调色、圆角等)
Fluent 主题允许覆盖系统级颜色和形状参数,无需重写全部样式。可在 FluentTheme 内部设置属性:
- AccentColor:设置主强调色(如蓝色按钮、选中状态色)
-
CornerRadius:统一控件圆角(默认
4,可设为0实现直角风格) - IsHighContrast:启用高对比度适配(辅助功能场景)
- 示例:
多主题共存与按需加载(进阶)
如需支持自定义主题(如深蓝、橙色主题)与 Fluent 并存,建议用资源字典切换而非直接替换 FluentTheme:
- 将不同主题封装为独立
ResourceDictionary(如BlueTheme.xaml) - 在运行时清空
Application.Current.Styles,再插入对应主题资源:
Application.Current.Styles.Clear();
Application.Current.Styles.Add(new StyleInclude(new Uri("avares://MyApp/Themes/BlueTheme.xaml"))); - 注意:这种方式会丢弃
FluentTheme的自动模式响应能力,需自行管理明暗逻辑
基本上就这些。Fluent 主题集成不复杂但容易忽略 NuGet 版本匹配和资源加载时机,只要确保包版本一致、样式注入位置正确,切换就能即时生效。










