在 JetBrains Rider 中创建 Avalonia 项目,不需要手动配置 SDK 或修改 csproj,官方已提供完整支持。关键是确保 Rider 版本较新(2022.3+),并启用 Avalonia 插件。
安装 Avalonia 插件
Rider 默认不内置 Avalonia 支持,需手动安装插件:
打开 Rider → Settings(或 Preferences on macOS)→ Plugins 搜索 AvaloniaRider(由 Avalonia 官方维护) 点击安装,重启 Rider创建新 Avalonia 项目
插件启用后,新建项目流程与 WPF/WinForms 类似:
点击 Create New Project 左侧选择 Avalonia(可能在 “Other” 或 “Cross-platform UI” 分类下) 选择模板:推荐 Avalonia Application (.NET)(基于 .NET 6/7/8 SDK) 填写项目名、路径,确认 SDK 版本(如 .NET 8.0)→ 点击 Create生成的项目自带
App.xaml、
MainWindow.xaml和启动逻辑,可直接运行。
验证与运行
首次运行前建议检查几项:
确保目标框架(如<targetframework>net8.0</targetframework>)已安装(可通过
dotnet --list-sdks查看) 右键项目 → Properties → 确认 Output Type 是 Windows Application(非 Console Application) 点击绿色 ▶️ 运行按钮,Rider 会自动调用
dotnet run并启动窗口
常见问题处理
如果创建时没看到 Avalonia 模板或运行报错:
检查 Rider 是否为最新稳定版(旧版本如 2021.x 对 Avalonia 11+ 支持不全) 插件安装后未重启 Rider → 重启再试 项目生成失败?可临时用命令行创建:dotnet new avalonia.app -n MyAvaloniaApp,再用 Rider 打开该文件夹 设计器不显示 XAML 预览?确保已启用插件且项目加载成功;部分版本需手动点击右上角 Refresh Designer
基本上就这些。Avalonia + Rider 的配合现在很成熟,只要插件到位、SDK 齐全,创建和开发体验接近原生。
