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
这一步会提供:
官方说明
(
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:
- Install .NET on Windows - .NET | Microsoft Learn
- Supported platforms
- Quick Start
- Setup your environment with uno-check
- The Uno Platform Solution Template