在 Windows 11 上使用 JetBrains Rider 2025.2 创建 Avalonia 项目完整指南

Avalonia 是一个跨平台的 .NET UI 框架，类似 WPF，可以在 Windows、Linux 和 macOS 上运行。JetBrains Rider 是 JetBrains 出品的跨平台 .NET IDE。本文将手把手教你在 Windows 11 下，使用 Rider 2025.2 创建第一个 Avalonia 项目。

---

1️⃣ 准备工作

1.1 安装 JetBrains Rider 2025.2

• 官网下载：https://www.jetbrains.com/rider/
• 安装完成后可以先打开 Rider，熟悉界面。

1.2 安装 .NET SDK

Avalonia 项目需要依赖 .NET SDK。

• 访问 .NET 官方下载页
• 建议安装 .NET 8 SDK（长期支持 LTS 版本）
• 安装时默认选项即可，确保勾选“添加到系统 PATH”。
• 安装完成后，重新打开 PowerShell，以确保 dotnet 命令可用。

1.3 验证 .NET SDK 是否安装成功

在 PowerShell 执行：

dotnet --list-sdks

如果看到类似：

8.0.102 [C:\Program Files\dotnet\sdk]

说明 SDK 安装成功。

---

2️⃣ 安装 Avalonia 模板

AvaloniaRider 插件主要提供 XAML 编辑和预览支持，并不会自动生成新项目模板。要新建 Avalonia 项目，还需要安装 Avalonia 的 .NET 模板。

在 PowerShell 中执行：

dotnet new install Avalonia.Templates

安装完成后，检查模板是否生效：

dotnet new list

你应该能看到：

Avalonia MVVM App
Avalonia App
Avalonia Control Library
...

如果你看到这些模板，就表示可以用命令行创建 Avalonia 项目了。

---

3️⃣ 安装 AvaloniaRider 插件

1. 打开 Rider → Settings / Preferences → Plugins

2. 搜索 AvaloniaRider 或 Avalonia

3. 点击安装，安装完成后重启 Rider

4. 插件提供：

   • XAML 编辑器
   • 预览窗口
   • 文件模板（Window、UserControl 等）

---

4️⃣ 创建 Avalonia 项目

Rider 有时候不会直接在“New Project”里显示 Avalonia 项目模板，这时可以用两种方式：

方式 1：命令行创建

dotnet new avalonia.mvvm -o MyAvaloniaApp

• MyAvaloniaApp 是你项目的文件夹名称
• 创建完成后，在 Rider 中选择 Open Solution 打开

方式 2：Rider 新建项目（可能在 Other / General 分类）

• 打开 Rider → New Solution / New Project
• 查看 Other 或 General 分类
• 如果模板可用，会看到 Avalonia .NET MVVM App 或 Avalonia App
• 选择模板 → 填写项目名 → 创建

如果仍然看不到模板，不影响开发，直接用 CLI 创建即可。

---

5️⃣ 第一次运行 Avalonia 项目

1. 打开项目后，Rider 会自动恢复 NuGet 包（如果没有，右键解决方案 → Restore NuGet Packages）
2. 选择项目 → Run
3. 第一个窗口应该成功显示，这是 Avalonia 的默认窗口

---

6️⃣ 常见问题排查

问题	解决方案
dotnet new 找不到命令	说明没有安装 .NET SDK 或 PATH 未生效 → 安装 SDK 并重启终端
新建项目中没有 Avalonia 模板	安装 Avalonia.Templates，或者用 CLI 创建项目
Rider 中 XAML 没有预览	确认 AvaloniaRider 插件已安装并启用
NuGet 包恢复失败	确认网络可访问 nuget.org，或手动 Restore

---

7️⃣ 小结

• .NET SDK + Avalonia.Templates → 支撑项目创建

• Rider + AvaloniaRider 插件 → 提供编辑和预览功能

• 推荐流程：

  1. 安装 .NET SDK
  2. 安装 Avalonia 模板
  3. 安装 AvaloniaRider 插件
  4. CLI 创建项目 → Rider 打开

这样即便 Rider 新建项目界面没有模板，也能顺利开始开发 Avalonia 项目。