MAUI怎么进行Windows平台开发 MAUI WinUI3开发教程

MAUI for Windows 基于 WinUI 3 运行时，需 VS 2022 17.4+、.NET SDK 6.0+/8.0+、Windows SDK 及 maui-windows 工作负载；默认生成桌面 EXE，支持条件编译调用原生 WinUI API，可选 MSIX 打包。

MAUI（.NET Multi-platform App UI）支持 Windows 平台开发，底层默认使用 WinUI 3（Windows App SDK），但要注意：MAUI 的 Windows 支持不是传统 WinUI 3 项目，而是通过 MAUI 的抽象层封装 WinUI 3 运行时，因此开发方式和纯 WinUI 3 项目不同——你不需要手动配置 WinUI 3 工程结构，也不用写 C++/WinRT 或 XAML Islands。

确认开发环境已就绪

MAUI for Windows 要求 Visual Studio 2022（17.4 或更高版本），且必须安装以下工作负载：

• .NET 桌面开发（含 .NET SDK 6.0+ 或 8.0+）
• 使用 C# 进行通用 Windows 平台开发（可选，但建议勾选以确保 WinUI 相关工具链完整）
• Windows 10/11 SDK（建议安装最新版，如 10.0.22621 或更高）

命令行验证：dotnet --list-sdks 应包含 6.0.300+ 或 8.0.x；dotnet workload list 中应有 maui 和 maui-windows（若缺失，运行 dotnet workload install maui-windows）。

创建并运行 MAUI Windows 项目

新建项目时选择 “.NET MAUI App”，创建后默认已启用所有平台。要只针对 Windows 构建，可：

• 在解决方案资源管理器中右键项目 → “属性” → “目标框架” 确保为 net8.0-windows10.0.22621.0（或对应 SDK 版本）
• 启动时选择调试目标为 “Windows Machine”（不是 “Windows (Package)” —— MAUI 不使用 MSIX 打包，默认走桌面 EXE 模式）
• 按 F5 运行，VS 会自动拉起 WinUI 3 容器并渲染 MAUI 页面

注意：首次运行可能较慢，因需部署 WinUI 3 运行时依赖；若报错“找不到 Microsoft.WindowsAppSDK.Runtime”，请检查是否安装了 Windows App SDK Runtime（可从 官方页面 单独下载安装）。

标签： windows app 工具 mac ai c++ windows10 资源管理器 win microsoft 开发环境