Avalonia MVVM框架怎么搭建 Avalonia MVVM项目创建教程

创建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 运行,看到空白窗口即成功

基本上就这些。后续加控件、绑数据、读文件,都基于这个结构展开,不复杂但容易忽略模板类型和绑定模式的选择。