Uno Platform 在 Windows 11 上的安装体验是目前跨平台 .NET UI 框架里做得最好的之一。下面给你一套官方推荐、稳定、少踩坑的安装流程，适合 Win 11 + 新项目。

> ✅ 以下步骤适用于 2026 年初、Uno Platform 5.x + .NET 9 的主流组合

---

一、整体安装流程概览（先看这个）

✨步子哥 · 2026-01-11T09:58:21+00:00

**C# 的 .NET Core（以及现在统一后的 .NET）可以运行在 macOS 和 Linux 上**，而且是**官方支持的跨平台运行环境**。 --- ## ✅ .NET / .NET Core 的跨平台支持 ### 支持的操作系统 .NET Core（从 .NET 5 起统一称为 **.NET**）**原生支持以下系统**： - ✅ **Windows** - ✅ **macOS** - ✅ **Linux**（Ubuntu、Debian、CentOS、Alpine、RHEL 等）同一份 C# 代码，通常无需修改即可在这些系统上运行。 --- ## ✅ 可运行的应用类型在 macOS / Linux 上可以运行： ### ✔ 控制台应用 ```bash dotnet run dotnet myapp.dll ``` ### ✔ Web 应用（ASP.NET Core） - Web API - MVC - Razor Pages - Minimal API > ASP.NET Core 本身就是为跨平台设计的 ### ✔ 后台服务 / 微服务 -

在 Windows 11 上安装 Uno Platform，推荐顺序是：

1. ✅ 安装 Visual Studio 2022 2. ✅ 安装 .NET SDK（8 / 9） 3. ✅ 安装 Uno Platform 扩展 4. ✅ 运行 uno-check（关键步骤） 5. ✅ 创建并运行第一个 Uno 项目

---

二、步骤 1：安装 Visual Studio 2022（必选）

✅ 推荐版本

Visual Studio 2022
版本要求：17.12 或以上（支持 .NET 9）

✅ 必选工作负载（非常重要）

在 VS Installer 中勾选：

✅ .NET 桌面开发 ✅ 使用 .NET 的移动开发 ✅ ASP.NET 和 Web 开发

> Uno 会用到桌面、WebAssembly、Android/iOS 的工具链

📌 Android / iOS 即使暂时不用，也建议先装，后面省事

官方说明：Visual Studio 与 .NET 版本对应关系 (learn.microsoft.com)

---

三、步骤 2：安装 .NET SDK

✅ 推荐安装

.NET 8（LTS）
.NET 9（Current）

可以同时安装，互不冲突。

> Uno Platform 当前模板和 Skia Desktop / WASM 都已支持 .NET 9 (platform.uno)

---

四、步骤 3：安装 Uno Platform 扩展

在 Visual Studio 中：

1. 打开 Extensions → Manage Extensions 2. 搜索 Uno Platform 3. 安装：

✅ Uno Platform

4. 重启 Visual Studio

这一步会提供：

项目模板
XAML 编辑支持
平台配置向导

官方说明 (platform.uno)

---

五、步骤 4：运行 uno-check（⚠️ 最关键）

> uno-check 是 Uno Platform 的“环境医生” > 会自动检测并安装你缺失的 SDK、工具、模拟器

✅ 安装 uno-check

dotnet tool install -g uno.check

或更新：

dotnet tool update -g uno.check

✅ 运行检查

uno-check

你会看到类似：

✅ .NET SDK
✅ Visual Studio Workloads
❌ Android SDK（可自动修复）
❌ WebAssembly Tools

👉 一路选择 Y 让它自动修复即可

官方文档 (platform.uno)

---

六、步骤 5：创建你的第一个 Uno 项目（推荐方式）

✅ 方式一：Visual Studio（最简单）

1. Create a new project 2. 搜索：Uno Platform App 3. 选择 Recommended 4. 选择平台（建议）：

✅ Skia Desktop（Windows / Linux / macOS）
✅ WebAssembly
✅ Windows App SDK

5. 创建并运行

---

✅ 方式二：命令行（更灵活）

dotnet new unoapp -n MyUnoApp
cd MyUnoApp
dotnet run -f net9.0-desktop

模板说明 (platform.uno)

---

七、你现在已经能做什么？

✅ 在 Windows 11 上运行 Uno 应用 ✅ 同一项目可运行：

Windows（WinUI / Skia）
Linux / macOS（Skia）
Web（WebAssembly）
Android / iOS（后续）

✅ 使用：

XAML
MVVM
WinUI API
CommunityToolkit

---

八、常见新手建议（少踩坑）

✅ 先从 Skia Desktop + Windows 开始 ✅ 不要一开始就全平台编译 ✅ uno-check 报错一定要修完再写代码 ✅ 升级 Uno / .NET 用 global.json 控制

---

✅ 一句话总结

> 在 Windows 11 上安装 Uno Platform 的正确姿势是： Visual Studio + .NET SDK + Uno 扩展 + uno-check，一次到位。

---

--- Learn more: 1. Install .NET on Windows - .NET | Microsoft Learn 2. Supported platforms 3. Quick Start 4. Setup your environment with uno-check 5. The Uno Platform Solution Template