在 JetBrains Rider 中创建 Avalonia 项目需安装官方 AvaloniaRider 插件并重启，新版 Rider（2022.3+）支持直接新建 Avalonia Application (.NET) 模板，自动生成 App.xaml、MainWindow.xaml 等文件，配置好目标框架后点击运行即可启动窗口。
在 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 和启动逻辑，可直接运行。
验证与运行
首次运行前建议检查几项：
- 确保目标框架（如
net8.0 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 齐全，创建和开发体验接近原生。
