安装VS 2022 17.4+并勾选.NET MAUI、.NET桌面、C++桌面开发工作负载，补全Android SDK/NDK（推荐25.1.8937393）、配置Xcode（macOS）及证书，可成功运行MAUI项目。
直接装 Visual Studio 2022（17.4 或更高版本）并勾选 .NET Multi-platform App UI 开发工作负载，就能跑起 MAUI 项目——但光点勾选还不够，几个关键细节不处理，新建项目会报错、模拟器打不开、iOS 构建失败很常见。
安装 VS 2022 并启用 MAUI 工作负载
去 Visual Studio 官网 下载 Community（免费）或 Professional 版本。安装时在“工作负载”页必须勾选：
- .NET Multi-platform App UI 开发
- .NET 桌面开发（MAUI Windows 后端依赖）
- 使用 C++ 的桌面开发（Android 构建链需要）
- Universal Windows Platform 开发（可选，仅需部署 UWP 时启用）
安装完成后，打开 VS，新建项目搜 “MAUI” ——如果没看到 “.NET MAUI App” 模板，说明工作负载未成功加载，可进 工具 → 获取工具和功能 重新勾选并修复。
Android 开发环境补全（Windows/macOS 均需）
VS 自带 Android SDK 和 NDK，但默认不安装全部组件。需手动补全：
Android Adb Skill
下载
Android 开发调试技能，通过系统 ADB 工具操作 Android 设备。以下场景必须触发此技能：(1) 直接 ADB 操作——安装 APK、查看设备列表、抓取 logcat 日志、查看已安装应用、清除应用数据、截图、重启设备、拉取/推送文件、查看 CPU/内存/电池信息、adb shell 操作；(2)...
- 打开 工具 → Android → Android SDK 设置
- 确保已安装：Android SDK Platform-34（或最新稳定版）、Android SDK Build-Tools 34.0.0、Android Emulator、Android SDK Platform-Tools
- NDK 版本建议选 25.1.8937393（MAUI 官方推荐兼容版），避免用最新 NDK 导致构建失败
模拟器建议用 VS 内置的 Hyper-V 加速 AVD（Windows）或 Rosetta 运行的 Simulator（macOS），首次启动可能卡住，多等 2–3 分钟或重启 VS 再试。
iOS/macOS 开发配置（仅 macOS 主机支持）
想打包 iOS 或 macOS 应用，必须在 macOS 上操作：
- 安装 Xcode 14.3 或更新版本（App Store 下载），并运行一次完成命令行工具授权：
xcode-select --install - 在 Xcode 中打开 Preferences → Locations，确认 Command Line Tools 已选中对应版本
- VS for Mac 需单独安装（非 Windows 上的 VS 远程连接），且必须登录 Apple ID 并配置开发者证书与 Provisioning Profile
- Windows 用户无法直接构建 iOS，只能通过 Mac Agent 连接，且网络、证书、密钥链权限常出问题，新手建议先专注 Android/Windows 调试
验证与常见问题速查
新建一个空 MAUI 项目（不勾选“包含单元测试”），点击运行：
- 能启动 Android 模拟器并显示 “Welcome to .NET MAUI!” → 环境基本就绪
- 报错 “The SDK ‘Microsoft.NET.Sdk.Maui’ was not found” → 清理 NuGet 缓存：
dotnet nuget locals all --clear，再重启 VS - 模拟器黑屏/无响应 → 检查 Hyper-V / WSL2 是否启用（Win11 默认开），或换用物理安卓手机 USB 调试
- Windows 启动报错 “Could not load file or assembly ‘Microsoft.Maui.Controls’” → 右键项目 → 属性 → 将“目标框架”设为 net8.0-windows10.0.19041.0 或更高
基本上就这些。MAUI 环境不是一步到位，但每步都有明确路径，卡住时看报错关键词+重装对应组件，比猜更高效。
