创建Avalonia MVVM项目只需三步:选Avalonia .NET MVVM App模板(.NET 6+,全平台勾选)、选CommunityToolkit MVVM或ReactiveUI框架并启用Compiled Bindings、运行含Views/ViewModels/App.axaml标准结构的项目即可成功启动。

直接上手创建一个 Avalonia MVVM 项目,核心就三步:选对模板、配好框架、跑通启动项。不需要从零写配置,官方模板已覆盖主流需求。
选对项目模板
在 Visual Studio 或 Rider 中新建项目时,找这几个关键选项:
- 模板名称必须是 Avalonia .NET MVVM App(不是普通 Avalonia App)
- 目标框架建议用 .NET 6.0 或更高版本(.NET 5.0 已过时,部分 NuGet 包可能不兼容)
- 平台勾选全选(Windows/macOS/Linux),Avalonia 默认支持跨平台,不用额外操作
- 如果 VS 插件没显示模板,先去「扩展 → 管理扩展」搜索安装 Avalonia for Visual Studio
确认 MVVM 框架和绑定方式
创建过程中会提示选择 MVVM Toolkit,默认选项通常是 ReactiveUI,但也可以选 CommunityToolkit MVVM(更轻量、微软官方维护):
- 选 CommunityToolkit MVVM:适合新手,属性通知靠
ObservableObject+SetProperty,代码简洁 - 选 ReactiveUI:适合需要响应式命令、路由、页面激活等高级能力的项目
- 务必开启 Compiled Bindings(编译时绑定),它能提升性能并让 XAML 绑定错误在编译阶段暴露
检查并运行项目结构
创建完成后,项目应自动包含标准 MVVM 分层目录:
-
Views/MainWindow.axaml:主窗口界面,
x:DataType应指向对应 ViewModel 类型 -
ViewModels/MainWindowViewModel.cs:继承
ObservableObject(CommunityToolkit)或ReactiveObject(ReactiveUI) -
App.axaml:全局样式与主题入口,可设
RequestedThemeVariant="Dark" - ViewLocator.cs:负责 View 和 ViewModel 的自动匹配,一般无需修改
- 右键项目 → 设为启动项目 → 按 Ctrl+F5 运行,看到空白窗口即成功
基本上就这些。后续加控件、绑数据、读文件,都基于这个结构展开,不复杂但容易忽略模板类型和绑定模式的选择。










