Avalonia介绍环境安装1、Visual Studio 2026安装2、.net framework安装3、Avalonia for Visual Studio4、安装官方模板项目创建1、模板选择2、MVVM框架选择新建项1. 桌面端开发必用2. 移动端/全平台开发才用3. 进阶封装控件才用4. 全局样式管理官网https://avaloniaui.net/文档https://docs.avaloniaui.net/docs/welcome环境安装1、Visual Studio 2026安装下载地址https://visualstudio.microsoft.com/zh-hans/downloads/社区版即可2、.net framework安装下载地址https://dotnet.microsoft.com/zh-cn/download/dotnet-framework安装Visual Studio 2026的时候会自动安装一个版本如果需要其他版本可以在这里下载3、Avalonia for Visual Studio扩展 - 管理扩展 https://docs.avaloniaui.net/docs/get-started/set-up-your-ide如果直接点击安装有问题可以直接去浏览器下载好了再安装https://marketplace.visualstudio.com/items?itemNameAvaloniaTeam.AvaloniaVS4、安装官方模板https://docs.avaloniaui.net/docs/get-started/install-avaloniadotnet newinstallAvalonia.Templates dotnet new list项目创建1、模板选择模板名称架构模式目标平台核心特点适用场景1. Avalonia .NET App非 MVVM(Code-Behind)纯桌面(Win/Linux/macOS)极简模式。无 ViewModelUI 和逻辑写在同一个.axaml.cs文件中。学习 Avalonia 基础、制作几行代码的微型工具、快速验证某个控件的用法。适合有WinForm开发基础2. Avalonia .NET MVVM AppMVVM(CommunityToolkit)纯桌面(Win/Linux/macOS)标准桌面开发首选。自带 ViewModel 和数据绑定UI 与逻辑分离结构清晰。绝大多数商业级桌面应用如后台管理工具、单机游戏客户端、桌面实用工具。适合有WPF开发基础3. Avalonia Cross Platform AppMVVM(CommunityToolkit)全平台(桌面 手机 Web)终极跨平台。一套代码生成桌面、Android、iOS、WebAssembly 等多个子项目。需要将软件同时发布到电脑、手机和网页的大型商业产品。2、MVVM框架选择在 Avalonia 的 MVVM 开发中CommunityToolkit.Mvvm微软官方维护和 ReactiveUIAvalonia 官方深度集成是两大主流框架。两者没有绝对的优劣之分核心区别在于编程范式和适用场景。维度CommunityToolkit.MvvmReactiveUI设计哲学传统命令式 源生成器极简轻量函数响应式编程 (FRP)流式数据管道学习曲线⭐ 极低传统 C# 思维几分钟上手⭐⭐⭐⭐ 较高需理解 Observable、LINQ 式操作符代码风格[ObservableProperty],[RelayCommand]属性标注this.WhenAnyValue(),.Select(),.Subscribe()链式调用异步处理async Task[RelayCommand]自动封装CreateAsyncTaskCommand()/ReactiveCommand.CreateFromTask()复杂状态联动手动在 setter 中调用其他方法/更新属性声明式管道多条件组合 (CombineLatest,Merge) 极其优雅性能编译时生成代码零反射极致性能运行时订阅/调度有轻微开销绝大多数场景可忽略Avalonia 集成原生支持绑定无特殊依赖Avalonia 官方深度集成内置RoutedViewHost,ViewModelViewHost等控件生态/文档微软官方维护文档完善社区庞大历史悠久Avalonia/WPF 老牌方案文档丰富但部分过时包体积~50KB (仅源码生成器)~2MB (含 System.Reactive 等依赖)新建项模板名称继承自核心作用与特点最佳适用场景Avalonia WindowWindow独立的主窗口。自带系统标题栏、最小化/最大化/关闭按钮在系统任务栏有独立图标。桌面应用的主程序窗口、独立的多文档窗口。Avalonia UserControlUserControl可复用的自定义 UI 控件块。没有独立窗口框架必须嵌套在 Window 或 Page 内部。页面内的局部功能模块如导航栏、数据表格、用户信息卡片。开发中最常用。Avalonia TemptedControlTemplatedControl自定义外观和行为的原生控件。不写死 UI 结构仅定义控件状态如按下、鼠标悬停UI 交给使用者自定义。开发复杂的第三方 UI 控件库或需要高度定制外观的通用控件。Avalonia ContentPageContentPage移动端/多页面的标准内容页。专为移动端Android/iOS和路由导航设计的页面容器。跨平台 App 的移动端独立页面通常配合路由导航框架使用。Avalonia DrawerPageDrawerPage侧滑/抽屉页面。类似移动端 App 的“侧边栏”或“抽屉菜单”Drawer通常从屏幕侧边滑出。App 的侧边导航菜单、移动端的功能面板。Avalonia NavigationPageNavigationPage提供导航栏的页面容器。自带顶部导航栏类似 iOS 的导航控制器提供前进/后退和标题。移动端 App 的多级页面跳转提供统一的顶部导航条。Avalonia TabbedPageTabbedPage标签页页面容器。提供底部的标签栏Tab Bar可以在多个 ContentPage 之间无缝切换。App 底部的 Tab 切换如微信底部的“微信/通讯录/发现/我”。Avalonia Resource DictionaryResourceDictionaryUI 资源集合文件。不包含 UI 界面只存放颜色、画刷、图标路径等可复用的静态资源。统一管理应用的颜色主题、图标资源实现换肤功能。Avalonia StylesStyles全局或局部样式文件。专门用于编写控件的样式Style和模板ControlTemplate。全局修改按钮、文本框等原生控件的默认外观统一管理 UI 风格。1. 桌面端开发必用如果你只做 Windows/macOS 桌面软件Avalonia Window和Avalonia UserControl是你每天都要用的两个核心模板。主界面新建Window。界面里的各个模块新建UserControl然后塞进Window里。建议日常开发 95% 的情况只需要这两个。2. 移动端/全平台开发才用ContentPage、DrawerPage、NavigationPage、TabbedPage是移动端/跨平台导航专用的模板。注意如果在纯桌面项目中用错了它们比如试图在 Window 内部直接塞一个 ContentPage 而不配合路由导航框架就会导致界面显示不出来的“坑”。3. 进阶封装控件才用TemplatedControl是给高级开发者用的。如果你只是想把几个现有的按钮和文本框拼在一起直接用UserControl就够了不要去碰TemplatedControl。4. 全局样式管理当你的项目超过 3 个页面或者开始做“亮色/暗色”主题切换时立刻建立Avalonia Resource Dictionary和Avalonia Styles把颜色和样式抽离出来这是专业 Avalonia 项目的标准做法。
