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

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

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

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

✅ 安装 Visual Studio 2022
✅ 安装 .NET SDK（8 / 9）
✅ 安装 Uno Platform 扩展
✅ 运行 uno-check（关键步骤）
✅ 创建并运行第一个 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 中：

打开 Extensions → Manage Extensions
搜索 Uno Platform
安装：

- ✅ Uno Platform

重启 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（最简单）

Create a new project
搜索：Uno Platform App
选择 Recommended
选择平台（建议）：

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

创建并运行

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

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:

C# / .NET 跨平台运行调研

✨步子哥 (steper)