Avalonia怎么在Rider中创建项目 Avalonia JetBrains Rider配置

在 JetBrains Rider 中创建 Avalonia 项目需安装官方 AvaloniaRider 插件并重启，新版 Rider（2025.3+）支持直接新建 Avalonia Applicati

on (.NET) 模板，自动生成 App.xaml、MainWindow.xaml 等文件，配置好目标框架后点击运行即可启动窗口。

在 JetBrains Rider 中创建 Avalonia 项目，不需要手动配置 SDK 或修改 csproj，官方已提供完整支持。关键是确保 Rider 版本较新（2025.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 是否为最新稳定版（旧版本如 2025.x 对 Avalonia 11+ 支持不全）
• 插件安装后未重启 Rider → 重启再试
• 项目生成失败？可临时用命令行创建：dotnet new avalonia.app -n MyAvaloniaApp，再用 Rider 打开该文件夹
• 设计器不显示 XAML 预览？确保已启用插件且项目加载成功；部分版本需手动点击右上角 Refresh Designer

基本上就这些。Avalonia + Rider 的配合现在很成熟，只要插件到位、SDK 齐全，创建和开发体验接近原生。