为Windows开发设置GitHub Copilot

本指南将指导你设置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 应用 - 使用最熟悉的任意一个。 下面的步骤会相应地进行标记,其中的体验有所不同。

先决条件


步骤 1:在 IDE 中安装GitHub Copilot

GitHub Copilot 内置于 Visual Studio 2026 中。 此选项卡介绍Visual Studio的设置。

  1. 打开Visual Studio并转到 Extensions>Manage Extensions。
  2. 搜索 GitHub Copilot并安装,或验证是否已安装。
  3. 通过 Tools>Options>GitHub>Accounts 登录。

有关详细设置,请参阅 Tutorial:使用 GitHub Copilot。

步骤 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引用和代码示例。

  1. 转到 Tools>Options>GitHub>Copilot>MCP 服务器。
  2. 使用 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 服务器

后续步骤

Tutorial:使用 GitHub Copilot