Skip to main content

GitHub Copilot 快速入门

GitHub Copilot 通过在你编写代码时提供内联建议,为你的工作提供帮助。

GitHub Copilot 适用于在 GitHub.com 上使用个人帐户的 GitHub 客户,以及企业帐户拥有的 GitHub Enterprise Cloud 组织。

GitHub Copilot 供经过验证的学生、教师和热门开源项目的维护人员免费使用。 如果你不是学生、教师或热门开源项目的维护人员,可以在一次性 60 天试用版中免费试用 GitHub Copilot。 免费试用后,需要付费订阅才能继续使用。 有关详细信息,请参阅“关于 GitHub Copilot 的计费”。

简介

GitHub Copilot 是 AI 结对程序员。 可以使用 GitHub Copilot 在编辑器中获取整行或整个函数的建议。

本指南将介绍如何通过个人帐户注册 GitHub Copilot,在 Visual Studio Code 中安装 GitHub Copilot 扩展,并获得第一个建议。 有关 GitHub Copilot 的详细信息,请参阅“关于 GitHub Copilot”。 有关如何在各种环境中使用 GitHub Copilot 的更深入信息,请参阅“入门”。

先决条件

  • GitHub Copilot 供经过验证的学生、教师和开放源代码维护者免费使用。
  • 如果你不是学生、教师或开放源代码维护者,则需要一个可用试用版或订阅。 有关详细信息,请参阅“关于 GitHub Copilot 的计费”。
  • 若要在 Visual Studio Code 中使用 GitHub Copilot,必须安装 Visual Studio Code。 有关详细信息,请参阅 Visual Studio Code 文档。

注册 GitHub Copilot

在开始使用 GitHub Copilot 之前,需要为个人帐户设置免费试用或订阅。

注意:如果你是 GitHub Enterprise Cloud 帐户拥有的组织的成员,并且拥有 GitHub Copilot 订阅,而且组织已为你分配了 GitHub Copilot 席位,则可以继续“为 Visual Studio Code 安装 GitHub Copilot 扩展”。

  1. 在任何页面的右上角,单击个人资料照片,然后单击“设置”。

    用户栏中的 Settings 图标

  2. 在边栏的“代码、规划和自动化”部分,单击“ GitHub Copilot”。

  3. 在 GitHub Copilot 设置页面上,单击“启用 GitHub Copilot”。

    GitHub Copilot 设置屏幕截图,其中突出显示了启用 GitHub Copilot 按钮

  4. 选择要按月还是按年付款,然后单击“继续访问 Copilot”。

    • 如果个人帐户符合免费 GitHub Copilot 订阅(而不是试用)的条件,将自动转到步骤 6。

    试用设置的屏幕截图,其中突出显示了“继续访问 Copilot”按钮

  5. 按照步骤确认付款详细信息,然后单击“提交”。

  6. 选择首选项,然后单击“保存并开始”。

    带有“保存并开始”按钮的 GitHub Copilot 设置屏幕截图

    可以稍后通过返回到 GitHub Copilot 设置来更改这些首选项。 有关详细信息,请参阅“在 Visual Studio Code 中配置 GitHub Copilot”。

为 Visual Studio Code 安装 GitHub Copilot 扩展

若要使用 GitHub Copilot,必须先安装 Visual Studio Code 扩展。

  1. 在 Visual Studio Code 市场中,转到 GitHub Copilot 扩展页,然后单击“安装”。 安装 GitHub Copilot 扩展 Visual Studio Code
  2. 此时会显示一个弹出窗口,要求打开 Visual Studio Code。 单击“打开 Visual Studio Code”。
  3. 在 Visual Studio Code 的“扩展: GitHub Copilot”选项卡中,单击“安装”。 Visual Studio Code 中的“安装”按钮
  4. 如果以前未在 GitHub 帐户中授权 Visual Studio Code,系统会提示你在 Visual Studio Code 中登录到 GitHub。
    • 如果以前已在 GitHub 帐户中授权 Visual Studio Code,系统将会自动授权 GitHub Copilot。 Visual Studio Code 授权屏幕的屏幕截图
  5. 在浏览器中,GitHub 将请求 GitHub Copilot 所需的权限。 若要批准这些权限,请单击“授权 Visual Studio Code”。
  6. 在 Visual Studio Code 的“Visual Studio Code”对话框中,若要确认身份验证,请单击“打开”。

获得第一个建议

Note: If you have duplication detection enabled for GitHub Copilot, you may receive limited suggestions, or no suggestions, when using the code examples provided. As an alternative, you can start by typing your own code to see suggestions from GitHub Copilot. For more information on duplication detection, see "Enabling or disabling duplication detection."

GitHub Copilot 为多种语言和各种框架提供建议,但尤其适用于 Python、JavaScript、TypeScript、Ruby、Go、C# 和 C++。 以下示例使用的是 JavaScript,但其他语言的工作方式类似。

  1. 打开 Visual Studio Code。

  2. 在 Visual Studio Code 中,创建一个新的 JavaScript (*.js) 文件。 1. 在 JavaScript 文件中,键入以下函数标头。

    ```javascript{:copy}
    function calculateDaysBetweenDates(begin, end) {
    ``` GitHub Copilot 将自动以灰色文本建议整个函数正文,如下所示。 具体的建议可能会有所不同。
    

    第一个建议 Visual Studio Code 1. 要接受建议,请按 Tab

后续步骤

你已成功安装 GitHub Copilot 并收到了你的第一个建议,但这只是开始! 以下是一些有用的资源,可帮助你对 GitHub Copilot 执行后续操作。

  • 入门:你已了解如何在 Visual Studio Code 中获得你的第一个建议。 这些指南介绍了如何在所有受支持的环境中设置和导航 GitHub Copilot 的各种功能。
  • GitHub Copilot:查看 GitHub Copilot 如何帮助你工作的实用示例。
  • 配置 GitHub Copilot:这些指南提供了有关如何将 GitHub Copilot 配置为个人首选项的详细信息。

延伸阅读