用 .NET MAUI 10 + VS Copilot 从 0 开发一个签到 App（二）开发环境搭建

用 .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 靠谱吗？
• 哪些代码必须人工介入？

到下一篇，我们真正开始写代码。🚀