跳至主要内容

使用 GitHub Copilot 代码审查

了解如何请求 GitHub Copilot 进行代码审查。

注意

关于 Copilot 代码审查

GitHub Copilot 可以审查您的代码并提供反馈。在可能的情况下,Copilot 的反馈包括建议的更改,您可以通过几次点击来应用这些更改。

Copilot 代码审查支持两种类型的审查

  • 审查选择:突出显示代码并请求初步审查(仅限 Visual Studio Code)
  • 审查更改:请求对所有更改进行更深入的审查(GitHub 网站和 Visual Studio Code)

以下表格总结了这两种审查类型的当前功能和可用性

功能审查选择审查更改
描述对突出显示的代码部分进行初步审查,并提供反馈和建议对所有更改进行更深入的审查
语言支持全部C#、Go、Java、JavaScript、Markdown、Python、Ruby、TypeScript
自定义编码指南支持是,请参阅使用编码指南自定义 Copilot 的审查
环境Visual Studio CodeVisual Studio Code 和 GitHub 网站
可用性公开预览,对所有 Copilot 订阅者可用公开预览,需加入候补名单,请参阅“加入 Copilot 代码审查候补名单

警告

不能保证 Copilot 能发现拉取请求中的所有问题或错误,有时它也会犯错。始终仔细验证 Copilot 的反馈,并以人工审查作为 Copilot 反馈的补充。

有关更多信息,请参阅“负责任地使用 GitHub Copilot 代码审查”。

请求 Copilot 审查

这些说明解释了如何在 GitHub 网站中使用 Copilot 代码审查。要查看 Visual Studio Code 的说明,请使用页面顶部的“Visual Studio Code”工具切换器。

请求 Copilot 进行拉取请求审查

注意

目前,仅限数量有限的 Copilot 订阅者可以请求 Copilot 进行拉取请求审查。要加入候补名单,请参阅“加入 Copilot 代码审查候补名单”。

  1. 在 GitHub.com 上,创建拉取请求或导航到现有的拉取请求。

  2. 打开审查者菜单,然后选择Copilot

    Screenshot of selecting 'Copilot' from the 'Reviewers' menu.

  3. 等待 Copilot 审查您的拉取请求。这通常需要不到 30 秒。

  4. 向下滚动并阅读 Copilot 的评论。

    Screenshot of a code review left by Copilot.

    Copilot 始终留下“评论”审查,而不是“批准”审查或“请求更改”审查。这意味着 Copilot 的审查不计入拉取请求所需的审查,并且 Copilot 的审查不会阻止合并更改。有关更多详细信息,请参阅“使用必需审查批准拉取请求”。

  5. Copilot 的审查评论的行为与来自人类的审查评论类似。您可以向其添加反应、对其进行评论、解决它们并隐藏它们。

    您添加到 Copilot 的审查评论中的任何评论都将对人类可见,但对 Copilot 不可见,并且 Copilot 不会回复。

使用 Copilot 提供的建议更改

在可能的情况下,Copilot 的反馈包括建议的更改,您可以通过几次点击来应用这些更改。

如果您对更改感到满意,您可以接受 Copilot 的单个建议并提交它,或者在单个提交中一起接受一组建议。有关更多信息,请参阅“将反馈合并到您的拉取请求中”。

如果您想验证 Copilot 的建议更改(例如通过运行自动化测试或您的 linter),或者如果您想在提交建议更改之前进行修改,请点击在工作区中打开按钮。有关更多信息,请参阅“使用 Copilot 帮助您处理拉取请求”。

提供 Copilot 审查的反馈

您可以直接在每条评论中提供对 Copilot 评论的反馈。我们使用此信息来改进产品和 Copilot 建议的质量。

  1. 在来自 Copilot 的拉取请求审查评论中,点击竖起大拇指(👍)或竖下大拇指(👎)按钮。

    Screenshot showing a Copilot code review comment with the thumbs up and thumbs down buttons.

  2. 如果您点击竖下大拇指按钮,系统会要求您提供其他信息。您可以选择性地选择您负面反馈的原因并在点击提交反馈之前留下评论。

    Screenshot of the form for providing additional information when you give negative feedback on a comment from Copilot.

请求 Copilot 重新审查

当您将更改推送到 Copilot 已审查的拉取请求时,它不会自动重新审查您的更改。

要请求 Copilot 重新审查,请点击按钮,该按钮位于审查者菜单中 Copilot 名称旁边。有关更多信息,请参阅“请求拉取请求审查”。

注意

在重新审查拉取请求时,Copilot 可能会再次重复相同的评论,即使它们已使用“解决对话”按钮或竖下大拇指(👎)按钮被驳回。

启用 Copilot 的自动审查

默认情况下,您必须在每个拉取请求上手动请求 Copilot 进行审查。

您可以使用在存储库级别或组织级别配置的规则集,为所有拉取请求启用 Copilot 的自动审查。有关更多信息,请参阅“关于规则集”。

要启用此功能,请启用在合并前请求 Copilot 对拉取请求进行审查分支规则,该规则嵌套在合并前需要拉取请求下。

Screenshot of the "Request pull request review from Copilot" branch rule.

使用编码指南自定义 Copilot 的审查

注意

自定义编码指南目前仅对 Copilot 代码审查公开预览中选定的参与者可用。从候补名单中被接受并不提供立即访问权限。此外,自定义编码指南仅作为 GitHub Copilot Enterprise 订阅的一部分提供。

在使用 Copilot 代码审查来审查 Visual Studio Code 或 GitHub 网站中的更改时,您可以使用自然语言编写的自定义编码指南来自定义 Copilot 的审查。当 Copilot 审查您的代码时,它会根据您的编码指南提供反馈。有关更多信息,请参阅“为 GitHub Copilot 代码审查配置编码指南”。

基于编码指南生成的评论将包含一条消息,突出显示其来源。

Screenshot of a comment produced from a custom coding guideline.

这些说明解释了如何在 Visual Studio Code 中使用 Copilot 代码审查。要查看 GitHub 网站的说明,请使用页面顶部的“网络浏览器”工具切换器。

注意

Copilot 代码审查仅在 Visual Studio Code 中使用版本 0.22 或更高版本的 GitHub Copilot Chat 扩展程序时可用。

审查代码选区

您可以在 Visual Studio Code 中请求对突出显示的代码选区进行初步审查。

  1. 在 Visual Studio Code 中,选择您要审查的代码。

  2. 打开 VS Code 命令面板

    • 适用于 Mac
      • 使用:Shift+Command+P
    • 适用于 Windows 或 Linux
      • 使用 Ctrl+Shift+P
  3. 在命令面板中,搜索并选择GitHub Copilot:审查和评论

    Screenshot of the command palette in Visual Studio Code with the GitHub Copilot: Review and Comment command selected.

  4. 等待 Copilot 审查您的更改。这通常需要不到 30 秒。

    Screenshot of the progress indicator when Copilot is performing a review in Visual Studio Code.

  5. 如果 Copilot 有任何评论,它们将显示在您的文件中内联,以及在问题选项卡中。

    Screenshot of a comment from Copilot in Visual Studio Code.

审查更改

注意

审查更改目前仅限数量有限的 Copilot 订阅者可用。要加入候补名单,请参阅“加入 Copilot 代码审查候补名单”。

您可以在 Visual Studio Code 中请求对暂存或未暂存的更改进行审查。

  1. 在 VS Code 中,切换到**源代码管理**选项卡。

  2. 要请求对未暂存更改的审查,请将鼠标悬停在侧边栏中的**更改**上,然后单击 **Copilot 代码审查 - 更改**按钮。

    Screenshot of the "Copilot code review - Changes" button in Visual Studio Code. The code review button is outlined in dark orange.

  3. 要请求对已暂存更改的审查,请将鼠标悬停在侧边栏中的**已暂存更改**上,然后单击 **Copilot 代码审查 - 已暂存更改**按钮。

  4. 等待 Copilot 审查您的更改。这通常需要不到 30 秒。

    Screenshot of the progress indicator when Copilot is performing a review in Visual Studio Code.

  5. 如果 Copilot 有任何注释,它们将显示在您的文件(s)中的内联,以及**问题**选项卡中。

    Screenshot of a comment from Copilot in Visual Studio Code.

使用 Copilot 提供的建议更改

在可能的情况下,Copilot 的反馈包括建议的更改,您可以单击一下应用这些更改。

Screenshot of a comment from Copilot in Visual Studio Code with a suggested change.

如果您对更改满意,可以通过单击**应用并转到下一个**按钮接受 Copilot 的建议。您应用的任何更改都不会自动提交。

如果您不想应用 Copilot 的建议更改,请单击**放弃并转到下一个**按钮。

提供 Copilot 审查的反馈

您可以直接在每条评论中提供对 Copilot 评论的反馈。我们使用此信息来改进产品和 Copilot 建议的质量。

要提供反馈,请将鼠标悬停在注释上并单击点赞或点踩按钮。

Screenshot of a comment from Copilot in Visual Studio Code with feedback buttons displayed. The buttons are outlined in dark orange.

使用编码指南自定义 Copilot 的审查

注意

自定义编码指南目前仅对 Copilot 代码审查公开预览中选定的参与者可用。从候补名单中被接受并不提供立即访问权限。此外,自定义编码指南仅作为 GitHub Copilot Enterprise 订阅的一部分提供。

在使用 Copilot 代码审查来审查 Visual Studio Code 或 GitHub 网站中的更改时,您可以使用自然语言编写的自定义编码指南来自定义 Copilot 的审查。当 Copilot 审查您的代码时,它会根据您的编码指南提供反馈。有关更多信息,请参阅“为 GitHub Copilot 代码审查配置编码指南”。

基于编码指南生成的评论将包含一条消息,突出显示其来源。