Avalonia 界面介绍及安装教程
界面入口
| 界面 | 能看到什么 | 适合场景 |
|---|---|---|
| Visual Studio + Avalonia 扩展 | 新建 Avalonia 项目模板、.axaml 编辑、XAML 设计器预览、热重载 | Windows 开发、WPF 迁移 |
| JetBrains Rider + AvaloniaRider | XAML 代码补全、属性导航、右侧 XAML 实时预览 | macOS/Linux 开发、跨平台开发 |
| VS Code | XAML 编辑、C# 调试、轻量预览 | 轻量开发、Linux 环境 |
| 运行中的应用窗口 | 桌面窗口、自定义主题、控件布局、移动端页面 | 验证 UI 效果、跨平台测试 |
典型开发界面是：左侧 解决方案资源管理器，中间 .axaml XAML 编辑器，右侧或下方 设计预览窗口；按 F5 运行后会弹出 Avalonia 应用窗口。
安装教程
1. 安装 .NET SDK
Avalonia 12 最低要求 .NET 8；如果要开发 Android/iOS，需要 .NET 10。
dotnet --version能输出版本号即可。
2. 安装 Avalonia 项目模板
dotnet new install Avalonia.Templates常用模板：
avalonia.app：基础桌面应用avalonia.mvvm：MVVM 结构应用，推荐avalonia.xplat：跨平台应用，含移动端/WebAssembly 目标
3. 配置 IDE
Visual Studio：
- 安装 “.NET 桌面开发” 工作负载
- 在扩展管理中搜索并安装 Avalonia for Visual Studio
- 重启后新建项目，搜索 Avalonia，选择模板即可
JetBrains Rider：
- Rider 已内置 Avalonia XAML 支持
- 可选安装 AvaloniaRider 插件，启用 XAML 实时预览
VS Code：
安装 C# 扩展和 Avalonia 相关扩展即可。
4. 创建并运行项目
dotnet new avalonia.mvvm -o MyAvaloniaApp
cd MyAvaloniaApp
dotnet run运行成功后会弹出一个窗口，说明环境安装完成。
常见问题
- 设计器不显示：先执行
dotnet build，确认项目能正常生成。 - VS 扩展安装后无模板：重启 Visual Studio，确认安装了 “.NET 桌面开发” 工作负载。
- Rider 没有预览：安装 AvaloniaRider 插件并重启。
- 升级旧项目到 Avalonia 12：需升级 .NET 8+，替换旧 NuGet 包，删除
.UseSkia()，并将Avalonia.Diagnostics改为AvaloniaUI.DiagnosticsSupport。