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（可从 官方页面 单独下载安装）。
访问原生 WinUI 3 API（可选进阶）
MAUI 允许在 Windows 平台上桥接到 WinUI 3 原生控件和功能，例如使用 Microsoft.UI.Xaml.Controls 中的 NavigationView 或调用 AppWindow 控制窗口行为。
- 在
MainPage.xaml.cs或页面后台代码中，用#if WINDOWS条件编译包裹原生调用 - 通过
MauiWinUIApplication.Current.Window.Content.As获取根元素，再用() FindName或VisualTreeHelper查找 WinUI 元素 - 示例：设置窗口标题栏颜色（需在
App.xaml.cs的OnLaunched中）：if (Microsoft.UI.Xaml.Window.Current != null) { var titleBar = Microsoft.UI.Xaml.Window.Current.AppWindow.TitleBar; titleBar.ButtonBackgroundColor = Colors.Transparent; }
打包与分发（非 MSIX，但支持）
MAUI 默认生成独立的桌面 EXE（含运行时），适合内部部署或简单分发。如需上架 Microsoft Store 或启用后台任务等高级能力，则需切换为 MSIX 打包：
- 修改项目文件（.csproj），添加：
Msix - 启用
Windows App SDK Packaged app模板（需 VS 17.5+ 及 Windows App SDK 1.4+） - 此时会生成
.msixbundle，可用MakeAppx或 Visual Studio 发布向导生成
注意：MSIX 模式下部分 API（如文件系统访问）需声明对应能力（Capabilities）并在 Package.appxmanifest 中配置。
基本上就这些。MAUI 的 Windows 开发本质是“WinUI 3 驱动的跨平台 UI 层”，不复杂但容易忽略运行时依赖和条件编译细节。动手前先跑通空白模板，再逐步接入原生能力，是最稳妥的路径。
