LanMountainDesktop/docs/archive/Plugins develop/01-快速开始/01-开发环境准备.md

01-开发环境准备

在开始开发阑山桌面插件之前，你需要准备好开发环境。本指南将带你完成所有必要的安装和配置。

---

✅ 系统要求

支持的操作系统

操作系统	版本要求	备注
Windows	Windows 10 版本 1809 或更高	推荐开发平台
Windows	Windows 11	最佳体验
Linux	Ubuntu 20.04+ / Debian 10+	支持开发和运行
macOS	macOS 12+	支持开发和运行

硬件要求

• 处理器：x64 或 ARM64 架构
• 内存：至少 4GB RAM（推荐 8GB）
• 磁盘空间：至少 2GB 可用空间

---

🛠️ 安装 .NET SDK

阑山桌面插件基于 .NET 10 开发，你需要安装对应版本的 SDK。

下载安装

1. 访问 .NET 10 下载页面
2. 下载适合你操作系统的 SDK 安装包
3. 运行安装程序，按提示完成安装

验证安装

打开终端（PowerShell、CMD 或 Bash），运行以下命令：

# 检查 .NET SDK 版本
dotnet --version

✅ 预期输出示例：

10.0.100

⚠️ 如果版本低于 10.0，请重新下载安装最新版 .NET 10 SDK。

---

💻 安装 IDE（集成开发环境）

你可以选择以下任一 IDE 进行开发：

选项 1：Visual Studio 2022（推荐 Windows 用户）

优点： 功能最全，调试体验最佳

1. 下载 Visual Studio 2022
2. 安装时选择以下工作负载：
   • ✅ .NET 桌面开发
   • ✅ Avalonia UI 开发（可选，如需 Avalonia 设计器）

选项 2：JetBrains Rider（跨平台推荐）

优点： 跨平台，智能提示强大，Avalonia 支持好

1. 下载 Rider
2. 安装后打开，会自动检测 .NET SDK

选项 3：Visual Studio Code（轻量级）

优点： 免费，轻量，插件丰富

1. 下载 VS Code
2. 安装以下扩展：
   • C# Dev Kit（Microsoft 官方）
   • Avalonia for VS Code（可选）

---

📦 安装插件模板

阑山桌面提供了官方的 dotnet new 模板，帮助你快速创建插件项目。

安装模板

# 安装最新版插件模板
dotnet new install LanMountainDesktop.PluginTemplate

✅ 成功提示：

模板名                                 短名称      语言  标签
-------------------------------------  ----------  ----  ------------
LanMountainDesktop Plugin              lmd-plugin  C#    LanMountainDesktop/Plugin

验证安装

# 列出已安装的模板，查找 lmd-plugin
dotnet new list | findstr lmd

或（Linux/macOS）：

dotnet new list | grep lmd

---

🎮 获取宿主应用

插件需要在阑山桌面宿主中运行，你需要获取宿主应用：

方式 1：下载 Release 版本（推荐）

1. 访问 GitHub Releases 页面
2. 下载最新版本的安装包（.exe / .deb / .dmg）
3. 安装并运行阑山桌面

方式 2：从源码构建

如果你想调试宿主或了解内部机制：

# 克隆仓库
git clone https://github.com/your-org/LanMountainDesktop.git
cd LanMountainDesktop

# 还原依赖
dotnet restore

# 构建项目
dotnet build LanMountainDesktop.slnx -c Debug

# 运行宿主
dotnet run --project LanMountainDesktop/LanMountainDesktop.csproj

---

🔍 环境验证清单

在继续之前，请确认以下检查项都已完成：

检查项	验证命令	预期结果
✅ .NET SDK 版本	dotnet --version	10.0.xxx
✅ 模板已安装	dotnet new list | findstr lmd	显示 lmd-plugin
✅ IDE 可创建项目	在 IDE 中新建项目	能看到 C# 项目模板
✅ 宿主可运行	双击 LanMountainDesktop.exe	应用正常启动

---

⚠️ 常见问题

问题 1：dotnet 命令找不到

现象： 运行 dotnet 提示不是内部或外部命令

解决：

1. 确认 .NET SDK 已正确安装
2. 重启终端或 IDE
3. 检查环境变量 PATH 是否包含 C:\Program Files\dotnet\

问题 2：模板安装失败

现象： dotnet new install 报错或卡住

解决：

1. 检查网络连接（需要访问 nuget.org）
2. 尝试指定版本号：

   dotnet new install LanMountainDesktop.PluginTemplate::1.0.0
   

3. 清除模板缓存后重试：

   dotnet new uninstall LanMountainDesktop.PluginTemplate
   dotnet new install LanMountainDesktop.PluginTemplate
   

问题 3：SDK 版本不匹配

现象： 构建时提示 SDK 版本不符合 global.json 要求

解决：

1. 检查项目根目录的 global.json 文件
2. 安装对应版本的 .NET SDK
3. 或使用以下命令使用已安装的版本：

   dotnet new globaljson --sdk-version 10.0.100 --roll-forward latestFeature
   

---

🎯 下一步

环境准备完成！接下来：

👉 02-三分钟创建第一个插件 - 立即开始创建你的第一个插件！

---

📚 参考资源

• .NET 10 下载
• Visual Studio 2022
• JetBrains Rider
• VS Code
• Avalonia UI 文档

---

最后更新：2026年4月