本指南将指导你设置GitHub Copilot,这些工具使它真正适用于Windows开发:WinUI 代理插件提供Copilot准确的Windows 应用 SDK上下文,以及提供Microsoft Learn MCP ServerCopilot官方Windows文档的实时访问。
小窍门
使用 VS Code 和 winapp CLI 生成新应用? 快速入门是一个更快的路径 , 它涵盖了单个端到端流中的相同工具。 如果要为现有Visual Studio工作流配置GitHub Copilot,请返回此处。
注释
可以使用 winapp CLI 使用 Visual Studio 或 VS Code 生成 WinUI 3 应用 - 使用最熟悉的任意一个。 下面的步骤会相应地进行标记,其中的体验有所不同。
先决条件
- GitHub Copilot 订阅(免费层可用)
- Visual Studio Code 或 Visual Studio 2026
- Node.js 18 或更高版本(Copilot插件安装命令需要)
步骤 1:在 IDE 中安装GitHub Copilot
GitHub Copilot 内置于 Visual Studio 2026 中。 此选项卡介绍Visual Studio的设置。
- 打开Visual Studio并转到 Extensions>Manage Extensions。
- 搜索 GitHub Copilot并安装,或验证是否已安装。
- 通过 Tools>Options>GitHub>Accounts 登录。
有关详细设置,请参阅
步骤 2:安装 WinUI 代理插件
来自 Awesome Copilot 社区仓库的 WinUI 代理插件 会教会 Copilot 正确的 Windows 应用 SDK 模式,从而避免诸如使用已弃用的 UWP API 之类的常见错误。
gh copilot plugin install winui@awesome-copilot
这会将代理、技能和自定义说明复制到项目的 .github/ 目录中。 下一次打开项目时,Copilot会自动拾取它们。 安装后,运行 copilot plugin list 并确认是否 winui3-development@awesome-copilot 显示在已安装的插件列表中。
小窍门
步骤 3:添加Microsoft Learn MCP 服务器
Microsoft Learn MCP Server为Copilot提供对官方Microsoft文档的实时访问权限,从而帮助其在编码时查找当前的API引用和代码示例。
- 转到 Tools>Options>GitHub>Copilot>MCP 服务器。
- 使用 URL 添加新服务器:
https://learn.microsoft.com/api/mcp
步骤 4:验证设置
打开Copilot 对话助手并尝试以下提示确认一切正常:
测试 WinUI 3 插件:
“在删除项目之前向 WinUI 3 应用添加确认对话框。”
Copilot 应使用包括所需 XamlRoot 设置的 ContentDialog 实现进行响应 - 插件的 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 应用
- 代理工具概述 - 所有工具的完整详细信息