GitHub Copilot 快速入门

本文内容

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

GitHub Copilot 可以通过具有 GitHub Copilot Individual 的个人帐户或通过具有 GitHub Copilot Business 的组织帐户进行管理。

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

简介

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

本指南将介绍如何为个人或组织帐户设置 GitHub Copilot 订阅，在 Visual Studio Code 中安装 GitHub Copilot 扩展，并获得第一个建议。 有关 GitHub Copilot 的详细信息，请参阅“About GitHub Copilot Individual”。 有关如何在各种环境中使用 GitHub Copilot 的更深入信息，请参阅“开始使用 GitHub Copilot”。

为个人帐户注册 GitHub Copilot

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

注意****：如果已经使用过 2021 年 7 月至 2022 年 6 月期间提供的免费 GitHub Copilot 技术预览版，则没有资格获得为期 30 天的试用。

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

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

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

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

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

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

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

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

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

注意：如果你作为 GitHub Enterprise Cloud 帐户拥有的组织的成员，拥有 GitHub Copilot 订阅，组织必须为你分配 GitHub Copilot 席位，然后你才能使用 GitHub Copilot。

为组织帐户注册 GitHub Copilot

开始在组织帐户中使用 GitHub Copilot 之前，需要设置订阅。

  1. 转到 GitHub Copilot Business 注册页。

  2. 选择要为其购买 GitHub Copilot 的组织，然后单击“继续”。

  3. 按照步骤确认付款详细信息，然后单击“保存”。

    如果文件中没有付款方法，系统将提示你添加一个。

  4. 在“公共代码建议”下拉列表中，选择“允许”或“阻止”以允许或阻止与公共代码匹配的建议，然后单击“保存并继续” 。 可以稍后通过返回 GitHub Copilot 设置来更改这些首选项。

  5. 为组织中的所有当前和未来用户或组织中的特定用户授予对 GitHub Copilot 的访问权限。

    • 如果选择了“允许所有成员”，请在“确认席位分配”对话框中单击“确认”，以确认要为组织中的所有当前和未来用户启用 GitHub Copilot 。
    • 如果选择了“选定的团队/用户”，则可以选择“添加人员”或“添加团队” 。
      • 如果选择了“添加人员”，则在“为组织所选成员启用 GitHub Copilot 访问权限”对话框中，可以搜索各个成员，也可以通过上传 CSV 文件批量添加成员。
      • 如果选择了“添加团队”，则在“为组织的选定团队启用 GitHub Copilot 访问权限”对话框中，首先在搜索栏中键入团队名称，选择要添加的团队，然后单击“将团队添加到访问列表” 。

  6. 要完成 GitHub Copilot Business 订阅的设置，请单击“保存并完成”。 组织成员将收到一封电子邮件，其中包含有关如何开始使用 GitHub Copilot 的说明。

为 Visual Studio Code 安装 GitHub Copilot 扩展

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

  1. 在 Visual Studio Code 市场中，转到 GitHub Copilot 扩展页，然后单击“安装”。

  2. 此时会显示一个弹出窗口，要求打开 Visual Studio Code。 单击“打开 Visual Studio Code”。

  3. 在 Visual Studio Code 的“扩展: GitHub Copilot”选项卡中，单击“安装”。

  4. 如果以前未在 GitHub 帐户中授权 Visual Studio Code，系统会提示你在 Visual Studio Code 中登录到 GitHub。

    • 如果以前已在 GitHub 帐户中授权 Visual Studio Code，系统将会自动授权 GitHub Copilot。

  5. 在浏览器中，GitHub 将请求 GitHub Copilot 所需的权限。 若要批准这些权限，请单击“授权 Visual Studio Code”。

  6. 在 Visual Studio Code 的“Visual Studio Code”对话框中，若要确认身份验证，请单击“打开”。

获得第一个建议

注意：如果为 GitHub Copilot 启用了重复检测，则使用提供的代码示例时，可能会收到有限的建议或没有建议。 作为替代方法，你可以首先键入自己的代码，以查看来自 GitHub Copilot 的建议。 有关重复检测的详细信息，请参阅“在 GitHub.com 上配置 GitHub Copilot 设置”。

GitHub Copilot 为多种语言和各种框架提供建议，但尤其适用于 Python、JavaScript、TypeScript、Ruby、Go、C# 和 C++。 GitHub Copilot 还可以帮助生成数据库的查询。 以下示例使用的是 JavaScript，但其他语言的工作方式类似。

  1. 打开 Visual Studio Code。

  2. 在 Visual Studio Code 中，创建一个新的 JavaScript (*.js) 文件。

  3. 在 JavaScript 文件中，键入以下函数标头。

    JavaScript
    function calculateDaysBetweenDates(begin, end) {

GitHub Copilot 将自动以灰色文本建议整个函数正文。 具体的建议可能会有所不同。

  1. 要接受建议，请按 Tab。

后续步骤

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

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

其他阅读材料