在 Visual Studio 中安装 GitHub Copilot

Visual Studio 中的 GitHub Copilot CompletionsGitHub Copilot Chat 可以在 Visual Studio 中实现增强的 AI 辅助开发,帮助你在编写代码时更加高效。

本文介绍如何在 Visual Studio 中安装 GitHub Copilot。 如果使用 Visual Studio 2022 版本 17.10 预览版 3 或更高版本,你将了解如何使用 IDE 中的 Copilot 锁屏提醒来管理 Copilot 状态。

获取适用于 Visual Studio 2022 版本 17.10 预览版 3 或更高版本 的 GitHub Copilot

对于 Visual Studio 2022 版本 17.10 预览版 3,GitHub Copilot 和 GitHub Copilot Chat 可合并到一个包中,作为单个扩展进行安装。 默认情况下,统一的 GitHub Copilot 扩展作为内置推荐组件,在所有工作负载中都有包含,你可通过 Visual Studio 安装程序获取它。

若要获取新的统一 GitHub Copilot 扩展,请执行以下操作:

  • 安装 Visual Studio 2022 版本 17.10 预览版 3 或更高版本
  • 在安装程序中选择至少一个工作负载。 请确保将预先选择的组件 GitHub Copilot 仍处于选中状态。 或者,如果未选择任何工作负载,请通过从安装程序中的单个组件中选择工作负载来安装 GitHub Copilot

默认情况下,GitHub Copilot 随所有工作负载一起安装。 如果选择排除它,则可以稍后进行安装,方式是:使用 Visual Studio 安装程序修改安装,并选择 GitHub Copilot 组件。

获取适用于 Visual Studio 2022 版本 17.8 到 17.9 的 GitHub Copilot

在 Visual Studio 2022 版本 17.8 到 17.9 中,GitHub Copilot 和 GitHub Copilot Chat 可作为两个单独的扩展进行安装。 安装 GitHub Copilot 扩展是安装 GitHub Copilot Chat 的先决条件。

安装 GitHub Copilot

可以通过以下方法之一获取 GitHub Copilot 扩展

安装 GitHub Copilot Chat

可以通过以下方法之一获取 GitHub Copilot Chat 扩展

使用 Visual Studio 安装程序进行安装

  1. 启动 Visual Studio 安装程序。

  2. 选择要修改的 Visual Studio 安装,然后选择“修改”

  3. 选择任何工作负载,例如“.NET 桌面开发”

  4. 从“可选”组件列表中选择“GitHub Copilot”,然后选择“修改”以安装扩展

    显示使用 Visual Studio 安装程序来安装 GitHub Copilot 组件的屏幕截图。

    注意

    在版本 17.9 或更低版本中,你将使用“管理扩展”对话框管理 GitHub Copilot 扩展的更新。

使用“管理扩展”对话框进行安装

  1. 打开 Visual Studio。
  2. 从菜单栏选择扩展>管理扩展
  3. 在“搜索”框中,输入“GitHub Copilot”或“GitHub Copilot Chat”。
  4. 选择扩展,然后选择“下载”按钮。
  5. 重启 Visual Studio 以完成安装过程。

注意

有关激活和授权的详细信息,请参阅 GitHub 文档中的“安装 Visual Studio 扩展”部分。

从 Visual Studio Marketplace 安装

Visual Studio Marketplace 直接下载并安装扩展。

管理 Copilot 状态

通过 Visual Studio 2022 版本 17.10 预览版 3,可在 Visual Studio 环境的右上角看到 Copilot 状态图标,指示 Copilot 是处于活动、非活动、不可用还是未安装状态。 使用状态图标中的下拉菜单,可以轻松地访问有助于管理 Copilot 状态或排查其状态问题的选项。 某些选项可用或灰显,具体取决于 Copilot 状态。

注意

请注意,状态图标正在从 Visual Studio 编辑器的底部面板移动。

Copilot 处于活动状态

如果已使用 GitHub 帐户登录到 Visual Studio,且该帐户具有对 GitHub Copilot for Individuals 或 GitHub Copilot for Business 的有效订阅,则 Copilot 处于活动状态,并且功能完全正常。

使用下拉菜单,可以轻松地打开“聊天”窗口、访问 Copilot 设置和管理 Copilot 订阅。

当 Copilot 处于活动状态时 Copilot 锁屏提醒的屏幕截图。

Copilot 处于非活动状态

如果 Copilot 已安装但处于非活动状态,可能是因为:

  • 你尚未使用 GitHub 帐户登录到 Visual Studio
  • 登录的 GitHub 帐户没有有效的 Copilot 订阅

从状态图标的下拉菜单中选择“添加具有 Copilot 订阅的 GitHub 帐户”以打开“帐户设置”,并使用具有有效订阅的 GitHub 帐户登录以使用 Copilot。 登录后,Copilot 状态图标将更新为活动状态。

当 Copilot 处于非活动状态时 Copilot 锁屏提醒的屏幕截图。

如果 Copilot 因为需要刷新已登录的 GitHub 帐户凭证而处于非活动状态,则请从下拉列表中选择“刷新 GitHub 凭证”以刷新 GitHub 帐户并再次登录。

如果你的管理员禁用 Copilot,则请联系 IT 管理员了解详细信息。

Copilot 不可用

如果 Copilot 已安装但无法使用,则可能是因为网络连接问题、服务器端技术问题或服务计划已过期。 在此状态下,Copilot 在外部问题得到解决之前不会提供其常规服务。

在下拉菜单中选择 Copilot 无法访问以打开“故障排除”页面,了解如何诊断和解决 GitHub Copilot 的常见网络错误。 当问题得到解决并且你已使用有效订阅登录后,Copilot 状态图标将更新为活动状态。

当 Copilot 不可用时 Copilot 锁屏提醒的屏幕截图。

Copilot 未安装

如果通过在安装程序中取消选中 GitHub Copilot 组件选择退出默认的建议安装,则状态图标在 IDE 中仍显示为可用。

从下拉菜单中选择“安装 Copilot”以安装 Copilot。 如果选择不安装 Copilot,可以从下拉列表中选择“隐藏 Copilot”,以从 IDE 隐藏 Copilot 状态图标。

未安装 Copilot 时 Copilot 锁屏提醒的屏幕截图。

后续步骤

若要了解详细信息,请考虑浏览以下资源:

Visual Studio 中的 GitHub Copilot Completions 入门Visual Studio 中的 GitHub Copilot Chat 入门