直接上手创建一个 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 运行,看到空白窗口即成功
基本上就这些。后续加控件、绑数据、读文件,都基于这个结构展开,不复杂但容易忽略模板类型和绑定模式的选择。
