用 .NET MAUI 10 + VS Copilot 从 0 开发一个签到 App（二）
一、本文目标
从这一篇开始，我们正式进入实战。
本文不会泛泛而谈「怎么安装 MAUI」，而是站在真实项目开发的角度，完整记录我在开发这个签到 App 过程中使用的环境配置，以及一些官方文档里很少提、但新手极容易踩坑的地方。
读完本文，你应该可以：
- 正确搭建 MAUI 10 开发环境
- 在 Visual Studio 中启用并“用对” Copilot
- 避开 Android / Windows 上最常见的环境问题
二、开发环境总览
我当前使用的开发环境如下（供参考）：
- 操作系统：Windows 10 / Windows 11
- IDE：Visual Studio 2026（最新版）
- .NET SDK：.NET 10 Preview（随 MAUI 10）
- MAUI：.NET MAUI 10
- AI 助手：Visual Studio Copilot
⚠️ 提醒：MAUI 10 仍处于演进阶段，建议始终使用 Visual Studio 最新版本，不要混用旧 SDK。
三、安装 Visual Studio 与 MAUI 工作负载
1️⃣ 必选工作负载
在 Visual Studio Installer 中，至少需要勾选以下内容：
- .NET Multi-platform App UI development
- .NET desktop development（用于 Windows 目标）
在右侧组件中，确认包含：
- Android SDK
- Android Emulator
- Windows 10/11 SDK
很多 MAUI 项目跑不起来，问题并不在代码，而是漏装了 SDK。
2️⃣ 创建第一个 MAUI 项目
在 Visual Studio 中：
新建项目 → .NET MAUI 应用
此时你会得到一个默认模板项目，包含：
- App.xaml
- AppShell.xaml
- MainPage.xaml
这个模板本身就已经是一个 MVVM + Shell 的最小骨架，非常适合作为真实项目的起点。
四、启用 Visual Studio Copilot
1️⃣ 安装 Copilot
在 Visual Studio 扩展管理中搜索并安装：
GitHub Copilot
安装完成后，重启 Visual Studio。
2️⃣ Copilot 的两种主要工作模式
在 MAUI 项目中，你会主要使用 Copilot 的两种能力：
- Inline Suggestion（写代码时自动补全）
- Copilot Chat（对话式生成 / 解释代码）
我的经验是：
XAML 更适合用 Chat，ViewModel 更适合 Inline
五、Copilot 推荐配置（非常实用）
在 Visual Studio 设置中，我强烈建议：
- 保持 Copilot Inline 自动提示开启
- Chat 窗口固定在右侧
- 不要开启“过度侵入式”的自动接受
原因很简单：
Copilot 生成的是“可能正确的代码”，而不是“已验证正确的代码”。
在 MAUI 项目中尤其如此。
六、Android 运行环境的关键问题
这是 MAUI 新手最容易卡住的一步。
常见问题
- 模拟器启动失败
- 应用部署卡在 Deploy 阶段
- 首次启动极慢
我的经验总结
- 优先使用 Android Emulator（x86_64）
- 第一次运行耐心等待（真的很慢）
- 一旦成功跑起来，后面会顺很多
如果你发现“什么都没错但就是跑不起来”，80% 是环境问题。
七、Windows 目标的注意事项
MAUI 在 Windows 上的体验相对最好，但也有几个点要注意：
- 需要 Windows 10 19041 以上
- 第一次运行会触发 WinUI 组件初始化
- 调试时建议先跑 Windows，再跑 Android
这可以显著减少排查成本。
八、这一阶段 Copilot 的真实价值
在环境搭建阶段，Copilot 的作用并不在“写代码”，而在：
- 解释模板代码
- 快速理解 AppShell / XAML 结构
- 帮助你判断哪些代码是可以删的
但请记住：
Copilot 不能替你解决 SDK、模拟器、系统权限问题。
九、下一篇预告
环境准备完成后，终于可以开始真正的功能开发了。
下一篇将进入第一个业务模块：
第 3 篇：使用 Copilot 生成第一个签到页面（XAML + MVVM）
我们会第一次正面检验：
- Copilot 写 UI 靠谱吗？
- 哪些代码必须人工介入？
到下一篇，我们真正开始写代码。🚀
