vs2022配置Avalonia环境
(1)安装vs2022
(2)安装插件

安装Avalonia for Visual Studio扩展
(3)项目模板
安装完Avalonia for Visual Studio扩展并重启Visual Studio后,项目模板会自动集成到Visual Studio中。
您无需再通过命令行手动安装,直接在创建新项目时即可看到Avalonia相关的模板选项。

(4)测试一个mvvm项目模板


在依赖项中的包中,可以看到自动添加了常用包:
图中 6 个 NuGet 包完整作用说明(Avalonia 11.3.11)
1. Avalonia (11.3.11) —— 框架核心底层包
核心渲染引擎、布局系统、XAML 解析器、基础控件库(Button/TextBox/Grid 等)
输入事件、样式系统、资源管理、绑定系统、跨平台抽象层
只包含平台无关逻辑,不能单独运行桌面程序,必须搭配对应平台包(如 Avalonia.Desktop)
2. Avalonia.Desktop (11.3.11) —— Windows/macOS/Linux 桌面平台适配层
封装 Win32、Cocoa、X11 窗口 API,创建原生窗口、消息循环
系统交互:文件对话框、剪贴板、拖拽、系统光标、屏幕 DPI 适配
桌面项目必备,提供
AppBuilder、DesktopWindow等桌面专属 API仅用于桌面端;移动端 / WebAssembly 项目不引用此包
3. Avalonia.Diagnostics (11.3.11) —— UI 调试诊断工具
内置可视化调试面板(快捷键 F12 唤起):查看控件树、样式、绑定、资源、布局尺寸
性能监控:渲染耗时、布局重绘、内存占用、事件追踪
样式热重载辅助、绑定错误日志、视觉树高亮查找控件
典型用法:
AppBuilder.UseDiagnostics()启用调试窗口
4. Avalonia.Fonts.Inter (11.3.11) —— Inter 开源无衬线字体资源包
内置 Inter 全套字重字体文件,解决多平台字体不一致问题
自动注册全局字体,项目全局文本默认使用 Inter,统一 Windows/macOS/Linux 显示效果
不含此包时,Avalonia 会 fallback 系统默认字体,界面中英文排版差异大
5. Avalonia.Themes.Fluent (11.3.11) —— Fluent Design 官方主题包
给所有原生控件提供现代化默认样式(圆角、阴影、动效、深浅色模式)
支持浅色 / 深色主题一键切换、自定义调色板、高对比度模式
新建 Avalonia 桌面项目默认自带,在
App.axaml中引用:<Application.Styles><FluentTheme /></Application.Styles>
不引用则控件无默认外观,会变成空白原生基础样式
6. CommunityToolkit.Mvvm (8.2.1) —— 微软官方 MVVM 工具包(非 Avalonia 官方)
核心功能:
ObservableObject(属性通知)、RelayCommand(命令绑定)、消息总线、弱引用通知配合 Avalonia 绑定系统实现 View 与 ViewModel 分离,替代传统后台代码逻辑
完全跨框架兼容:WPF/UWP/WinUI/Avalonia 通用,和 Avalonia 无版本绑定关系

编译无问题,就说明环境已经配置好了。