Skip to main content

GitHub Copilot 快速入门

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

谁可以使用此功能?

可通过 GitHub Copilot Individual的个人账户,通过组织 或通过 GitHub Copilot Business企业帐户,或通过 GitHub Copilot Enterprise 企业帐户对 GitHub Copilot 进行管理。

GitHub Copilot 供经过验证的学生、教师和热门开源项目的维护人员免费使用。 有关详细信息,请参阅“关于 GitHub Copilot 的计费”。

简介

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

可以通过具有 GitHub Copilot Individual 订阅的个人帐户或具有 GitHub Copilot Business 或 GitHub Copilot Enterprise 订阅的组织或企业帐户来使用 GitHub Copilot。 若要通过组织帐户使用 Copilot,则必须为你的组织分配 GitHub Copilot 席位。

本指南将介绍如何为个人帐户设置 GitHub Copilot 订阅,在 Visual Studio Code 中安装 GitHub Copilot 扩展,并获得第一个建议。 对于组织所有者 和企业所有者,本指南还说明了如何设置 GitHub Copilot Business 或 GitHub Copilot Enterprise 订阅。

有关如何在各种环境中使用 GitHub Copilot 的更深入信息,请参阅“开始使用 GitHub Copilot”。

为个人帐户注册 GitHub Copilot

需要先为 GitHub Copilot Individual 设置免费试用或订阅,然后才能开始通过个人帐户使用 GitHub Copilot。

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

  1. 在任意页面的右上角,单击个人资料照片,然后单击 你的 Copilot”****。

  2. 在 GitHub Copilot 设置页面上,单击“开始免费试用****”。

  3. 选择按月付费还是按年付费,然后单击“获取 GitHub Copilot 的访问权限”。****

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

  4. 按照步骤输入并确认付款详细信息,然后单击“提交”。****

  5. 选择首选项,然后单击“保存并完成设置”。****

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

为 Visual Studio Code 安装 GitHub Copilot 扩展

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

  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 Business

作为企业所有者,你可以向企业帐户添加 GitHub Copilot Business 订阅。 然后,为 Copilot 启用的组织的所有者就能够为组织成员分配 GitHub Copilot 席位。 有关详细信息,请参阅“管理组织中对 Copilot 的访问权限”。

签订了 Microsoft 企业协议的客户

如使用 Microsoft 企业协议,需将 Azure 订阅 ID 连接到企业帐户才能启用 GitHub Copilot 并支付其费用。 有关详细信息,请参阅“连接 Azure 订阅”。

签订了直接 GitHub 合同的客户

  1. 转到 GitHub Copilot Business 注册页

  2. 若要为企业购买 GitHub Copilot,请选择“在企业级启用 GitHub Copilot”,然后单击“继续” 。

  3. 选择要为其购买 GitHub Copilot 的企业,然后单击“继续”。

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

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

为企业帐户注册 GitHub Copilot Enterprise

作为企业所有者,你可以向企业帐户添加 GitHub Copilot Enterprise 订阅。 然后,为 Copilot 启用的组织的所有者就能够为组织成员分配 GitHub Copilot 席位。 有关详细信息,请参阅“管理组织中对 Copilot 的访问权限”。

签订了 Microsoft 企业协议的客户

如使用 Microsoft 企业协议,需将 Azure 订阅 ID 连接到企业帐户才能启用 GitHub Copilot 并支付其费用。 有关详细信息,请参阅“连接 Azure 订阅”。

签订直接 GitHub 合同的客户

注册 GitHub Copilot Enterprise 的流程会有所不同,具体取决于企业是第一次使用 GitHub Copilot 还是从 GitHub Copilot Business 升级。

在没有 GitHub Copilot Business 的情况下注册 GitHub Copilot Enterprise

  1. 在浏览器中,导航到 github.com/github-copilot/signup/plans
  2. 选择 GitHub Copilot Enterprise,然后单击“启用 Copilot Enterprise”。
  3. 按照提示操作,完成注册流程。

从 GitHub Copilot Business 升级到 GitHub Copilot Enterprise

购买 Copilot Enterprise 时,企业中所有现有 Copilot Business 席位都将转换为 Copilot Enterprise 计划并相应计费。 不能在同一企业内同时拥有 Copilot Enterprise 和 Copilot Business 席位。

  1. 在 GitHub.com 的右上角,单击你的个人资料照片,然后单击“你的企业”。

  2. 在企业列表中,单击您想要查看的企业。

  3. 在企业帐户边栏中,单击“ 策略”。

  4. 在“ 策略”下,单击 Copilot

  5. 在“访问管理”选项卡的“Copilot Business 在企业中处于活动状态”部分中,单击“启用 Copilot Enterprise”。

  6. 在显示的“欢迎使用 Copilot Enterprise”弹出窗口中,单击“购买 Copilot Enterprise”。

  7. 按照提示操作,完成注册流程。

为企业帐户启用 GitHub Copilot

用户只有在被他们所属的组织授予 Copilot 席位后,才能使用 GitHub Copilot。

作为企业所有者,你必须决定是允许企业中的所有组织还是特定组织具有向成员授予 GitHub Copilot 席位的能力。 最初,在购买 GitHub Copilot Business 或 GitHub Copilot Enterprise 后,没有组织能够授予 GitHub Copilot 席位,因此必须为部分或所有组织启用该功能。

  1. 在企业帐户边栏中,单击“ 策略”。

  2. 在“ 策略”下,单击 Copilot

  3. 在“访问权限管理”选项卡中的“管理组织对 GitHub Copilot 的访问权限”下,配置 GitHub Copilot 订阅的访问权限。

    • 若要为企业中的所有组织(当前和将来)启用 GitHub Copilot,请选择“允许所有组织”。
    • 若要为特定组织启用 GitHub Copilot,请选择“允许特定组织”。
  4. 如果选择了“允许特定组织”,请选择要为其启用 GitHub Copilot 的组织。 或者,可以选择要禁用 GitHub Copilot 访问的组织。

    启用组织时,该组织的所有者将收到一封电子邮件,其中包含有关如何为组织成员启用 GitHub Copilot 的说明。

  5. 单击“策略”选项卡。

  6. 在“与公共代码匹配的建议”下,单击下拉菜单,然后选择用于管理与企业中公共代码匹配的 GitHub Copilot 建议的使用的策略。

    • 若要阻止与公共代码匹配的 GitHub Copilot 建议,请选择“已阻止”。
    • 若要允许与公共代码匹配的 GitHub Copilot 建议,请选择“已允许”。
    • 若要允许每个组织设置自己的策略,请选择“无策略”。
  7. 如果你有 GitHub Copilot Enterprise 订阅,请在“GitHub.com 中的 Copilot”下,单击下拉菜单并选择管理 GitHub.com 中 Copilot 的使用的策略。

    • 若要允许每个组织设置自己的策略,请选择“无策略”。
    • 要为企业中的所有组织启用 Copilot Chat,请选择“已启用”。
    • 若要为企业中的所有组织禁用 Copilot Chat,请选择“已禁用”。

    如果选择“已启用”,请使用显示的复选框来指定是否要:

    • 允许 Copilot Chat 在回答有关 GitHub.com 的问题时使用必应搜索。
    • 允许 GitHub 收集用户反馈,可以选择在使用 Copilot 生成拉取请求摘要后提交。

    有关详细信息,请参阅“启用 GitHub Copilot 企业版功能”。

  8. 在 IDE 中的“Copilot Chat”下,单击下拉菜单并选择用于管理代码编辑器应用程序中 Copilot Chat 的使用的策略。

    • 若要允许每个组织设置自己的策略,请选择“无策略”。
    • 要为企业中的所有组织启用 Copilot Chat,请选择“已启用”。
    • 若要为企业中的所有组织禁用 Copilot Chat,请选择“已禁用”。
  9. 在 CLI 中的“Copilot”下,单击下拉菜单并选择用于管理终端中 Copilot 的使用的策略。

    • 若要允许每个组织设置自己的策略,请选择“无策略”。
    • 若要在 CLI 中为企业中的所有组织启用 Copilot,请选择“已启用”。
    • 若要为企业中的所有组织禁用 Copilot,请选择“已禁用”。

后续步骤

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

延伸阅读