新建maui项目无法运行的三大主因是：未接受android sdk许可、未启用hyper-v或windows hypervisor platform、缺失.net maui工作负载及net8.0-android框架；需依次手动接受sdk许可、开启虚拟化功能、安装maui工作负载并确认sdk版本为.net 8。
新建 MAUI 项目后跑不起来，不是代码问题，而是环境没配好——dotnet new maui 生成的模板本身没问题，但默认卡在 Android SDK 许可、Hyper-V、net8.0-android 框架缺失这三关。
Android SDK 许可没接受，编译直接报错
VS 编译时错误列表里出现类似 The license for package Android SDK Platform 34 is not accepted. 的提示，这是最常见拦路虎。VS 不会自动帮你点“Accept”，必须手动触发。
- 双击错误列表里的那条报错，会弹出许可窗口；别只点一个，通常要逐个接受 3–5 个许可（含
platform-tools、build-tools、platforms;android-34） - 命令行下也可补救：
yes | sdkmanager --licenses（需确保sdkmanager在 PATH 中） - 许可路径默认在
%USERPROFILE%\AppData\Local\Android\Sdk\licenses，若该目录为空或无android-sdk-license文件，说明根本没签过
Hyper-V 或 Windows Hypervisor Platform 未启用
模拟器启动卡在 “Creating device…” 或启动后 CPU 占满、黑屏，八成是虚拟化没开。Windows 家庭版用户尤其要注意：它原生不支持 Hyper-V。
- 打开“启用或关闭 Windows 功能”，勾选
Hyper-V和Windows Hypervisor Platform，重启生效 - Windows 11 家庭版必须改用 WSL2 + Android Emulator，否则模拟器无法硬件加速，启动极慢甚至失败
- 启动模拟器时若弹出 “Enable Windows Hypervisor Platform”，务必点
Run Anyway，否则即使开了功能也无效
Visual Studio 缺少 .NET MAUI 工作负载或 Android SDK 组件
只装了 .NET SDK 不等于能开发 MAUI —— 工作负载（workload）是独立安装项，漏掉就编译不过，且错误信息往往不明确。
- 进 Visual Studio Installer → 修改当前实例 → 勾选
.NET Multi-platform App UI development工作负载 - 确认子项中已安装
.NET MAUI Android/iOS development tools和Android SDK setup - 运行
dotnet workload list，输出里必须含maui和android；若没有，手动执行dotnet workload install maui - 检查
dotnet --list-sdks，确保有8.0.x（如8.0.400）条目；MAUI 项目不兼容 .NET 6 以下版本
模拟器镜像选错或渲染设置不当
点“Android Emulator”下拉菜单后没反应，或启动后白屏/卡死，问题常出在 AVD 配置上，而非网络或磁盘空间。
- 用 VS 内置的
Android Device Manager（工具 → Android → Android Device Manager）创建设备 - 镜像必须选带
Google APIs的 x86_64 版本（如Pixel 5 API 34），别选 Android TV、Wear OS 或 ARM64 镜像 - 编辑设备 →
Show Advanced Settings→Graphics改为Hardware - GLES 2.0；选 Software 渲染会导致启动超慢或黑屏 - 首次启动可能耗时 5 分钟以上，状态栏显示
Running且底部出现Stop按钮才算真正就绪
平台特定代码放错位置、硬编码宽高、中文路径导致资源打包失败……这些都可能让应用跑起来却立刻闪退。但第一步永远是：先让模拟器真正亮屏，再谈业务逻辑。
