本指南将指导你设置 GitHub Copilot 以及使它真正适用于 Windows 开发的工具: WinUI 3 开发插件 ,该插件提供 Copilot 准确的 Windows 应用 SDK 上下文,以及提供 Copilot 实时访问官方 Windows 文档 的 Microsoft Learn MCP Server 。
注释
生成和调试 WinUI 3 应用需要 Visual Studio — VS Code 没有 MSIX 生成工具或 WinUI 项目模板。 如果你正在通过 winapp CLI 处理其他 Windows 框架(Electron、Flutter、.NET 或 Rust),VS Code 适用于这些框架。 以下步骤被相应地标记。
先决条件
- GitHub Copilot 订阅(免费层可用)
- Visual Studio Code 或 Visual Studio 2026
- Node.js 18 或更高版本(Copilot 插件安装命令需要)
步骤 1:在 IDE 中安装 GitHub Copilot
GitHub Copilot 内置于 Visual Studio 2026 中。 WinUI 3 开发需要 Visual Studio。
- 打开 Visual Studio 并转到 “扩展>管理扩展”。
- 搜索 GitHub Copilot 并安装它,或验证是否已安装。
- 通过 工具>选项>GitHub>帐户登录。
有关详细设置,请参阅 Visual Studio 中的 GitHub Copilot。
步骤 2:安装 WinUI 3 开发插件
来自 Awesome Copilot 社区存储库的 WinUI 3 开发插件介绍了 Copilot 正确的 Windows 应用 SDK 模式,从而防止使用弃用的 UWP API 等常见错误。
在项目的根目录(或任何您希望 Copilot 捕捉插件的目录)中执行此命令:
copilot plugin install winui3-development@awesome-copilot
这会将代理、技能和自定义说明复制到项目的 .github/ 目录中。 在下次打开项目时,Copilot 会自动选取它们。
小窍门
还可以使用 Awesome Copilot 扩展直接从 VS Code 浏览和安装 Copilot 插件。
步骤 3:添加Microsoft Learn MCP 服务器
Microsoft Learn MCP 服务器为 Copilot 提供了对微软官方文档的实时访问,使它在帮助您编写代码时能够查找最新的 API 引用和代码示例。
- 转到 工具>选项>GitHub>Copilot>MCP 服务器。
- 使用 URL 添加新服务器:
https://learn.microsoft.com/api/mcp
步骤 4:验证设置
打开 Copilot 聊天并尝试以下提示以确认一切正常:
测试 WinUI 3 插件:
“在删除项目之前向 WinUI 3 应用添加确认对话框。”
Copilot 应该通过一个ContentDialog实现来响应,其中包括所需的XamlRoot设置——插件的 Windows 应用 SDK 上下文将其引导到正确的现代化 API,而不需要您指定要避免的内容。
测试 Learn MCP 服务器:
“查找最新的 Windows 应用 SDK 发行说明,并告诉我新增功能。
Copilot 应从 Microsoft Learn 中提取当前发行说明并汇总它们。
可选:添加更多 Windows MCP 服务器
使用其他特定于 Windows 的 MCP 服务器进一步扩展 Copilot 的上下文:
| MCP 服务器 | 它为 Copilot 提供了什么 | URL/设置 |
|---|---|---|
| Azure DevOps | 访问工作项、PR 和内部版本 | Azure DevOps MCP 服务器 |
后续步骤
- 使用 Copilot 现代化或移植 Windows 应用
- 适用于 Windows 开发的代理 AI 工具 - 所有工具的完整详细信息