Avalonia UI 跨平台框架技术调研

Avalonia UI 是面向 .NET 的 跨平台 XAML UI 框架，支持 Windows、macOS、Linux、iOS、Android 与 WebAssembly，被誉为「开源 WPF/UWP 精神继承者」。2026 年适合 C#/.NET 团队 构建原生观感桌面应用，并与现有 .NET 后端、Azure 生态深度集成。

一、 基本信息

二、 技术定位与简介

Avalonia 使用 自绘渲染管线（非系统原生控件），保证跨平台视觉一致：

• AXAML：XAML 标记 + C# 代码后置或 MVVM。
• 样式系统：类似 WPF 的 Style、ControlTheme、伪类。
• 数据绑定：INotifyPropertyChanged、ReactiveUI、CommunityToolkit.Mvvm。

与 MAUI 不同，Avalonia 更专注 桌面级 UI 密度与定制，在 Linux 桌面支持上口碑优于 MAUI。

三、 快速上手安装说明

dotnet new install Avalonia.Templates
dotnet new avalonia.app -o MyApp
cd MyApp
dotnet run

AXAML 示例

<!-- MainWindow.axaml -->
<Window xmlns="https://github.com/avaloniaui"
        Width="400" Height="300" Title="Hello Avalonia">
  <StackPanel Margin="20">
    <TextBlock Text="{Binding Greeting}" />
    <Button Content="Click" Command="{Binding ClickCommand}" />
  </StackPanel>
</Window>

// ViewModel
public partial class MainViewModel : ObservableObject
{
    [ObservableProperty] private string _greeting = "Hello Avalonia";
    [RelayCommand] void Click() => Greeting = "Clicked!";
}

发布

dotnet publish -c Release -r win-x64 --self-contained
dotnet publish -c Release -r osx-arm64
dotnet publish -c Release -r linux-x64

四、 核心特性

1. 跨平台 XAML

一套 AXAML 覆盖桌面与移动。

2. MVVM 一等公民

与 ReactiveUI、Prism 等模式契合。

3. 自绘渲染

Skia 后端，样式跨平台一致。

4. 丰富控件

DataGrid、TreeView、TabControl、Fluent 主题。

5. 设计器支持

Rider、Visual Studio 扩展、Avalonia DevTools。

6. 开源 MIT

无平台附加费，商业友好。

五、 适用场景

适合：.NET 企业客户端、WPF 迁移、Linux 桌面支持、工具软件、金融/工控界面。

不适合：团队只会 JavaScript、需直接复用 React 组件、极端嵌入式（选 Slint/Qt MCU）。

六、 技术亮点

1. WPF 开发者友好——XAML 与绑定概念高度相似。
2. Linux 桌面——少数成熟 .NET GUI 方案之一。
3. Avalonia 11——性能与移动端支持显著增强。
4. 主题与 Fluent——现代设计语言内置。
5. 活跃社区——NuGet 包与模板持续增长。

七、 核心概念与架构

digraph Avalonia_Arch {
  rankdir=TB
  node [shape=box, style="rounded,filled", fillcolor="#f0f9ff"]
  AXAML [label="AXAML + Code-behind", fillcolor="#bae6fd"]
  Layout [label="布局测量/排列"]
  Render [label="Skia 渲染后端"]
  Input [label="输入/焦点/无障碍"]
  Platform [label="平台窗口 Host"]
 
  AXAML -> Layout -> Render -> Platform
  Input -> Layout
}

StyledProperty、AttachedProperty 与路由事件构成样式与交互基础。

八、 技术局限与边界

1. 非原生控件——外观自绘，与 OS 原生控件行为偶有差异。
2. 生态小于 WPF——第三方控件商数量少于 Windows 专有栈。
3. 移动端——可用但市场份额低于 Flutter/MAUI 纯移动方案。
4. 学习曲线——XAML + MVVM 对 Web 开发者陌生。
5. WebAssembly——浏览器端仍属补充场景，非主战场。
6. MAUI 重叠——微软官方 MAUI 与 Avalonia 选型需组织级决策。

九、 生态地图

ReactiveUI、Prism.Avalonia、Semi.Avalonia、Material.Avalonia、Eremex、Dock.Avalonia、AvaloniaEdit、LiveCharts2。

十、 生态集成

十一、 开发与工程化

• 默认 MVVM：View 无逻辑，ViewModel 可单测。
• 使用 CompiledBinding 提升绑定性能与编译检查。
• 主题资源字典分层：Colors.axaml、Controls.axaml。
• 多项目解决方案：Core（模型）+ Desktop + 可选 Mobile。
• 启用 Avalonia.Analyzers 捕获 AXAML 错误。

十二、 性能与安全

• 虚拟化 ItemsControl 处理大列表；避免过度绑定刷新。
• 敏感配置用 ProtectedData 或 OS 密钥链（macOS Keychain、Windows DPAPI）。
• 自动更新：Squirrel、自定义签名增量包。
• 依赖 dotnet list package --vulnerable 定期审计。

十三、 技术对比

十四、 最佳实践

1. WPF 迁移先对照 WPF 兼容性文档 评估控件差距。
2. 使用 Design.DataContext 在设计器预览假数据。
3. 高 DPI：测试 PerMonitorV2 与 SVG 图标。
4. Linux 打包验证 deb/rpm/AppImage 与依赖 glibc 版本。
5. 无障碍：为自定义控件补充 AutomationProperties。

十五、 学习与社区资源

• 文档：https://docs.avaloniaui.net/
• GitHub：https://github.com/AvaloniaUI/Avalonia
• Telegram/Discord：https://avaloniaui.net/community
• Samples：https://github.com/AvaloniaUI/Avalonia.Samples