我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们
文章版本: GitHub.com

审查拉取请求中的建议更改

在拉取请求中,您可以审查和讨论提交、更改的文件以及基本和比较分支中文件之间的区别(或“差异”)。

本文内容

关于审查拉取请求

您可以在拉取请求中每次审查一个文件的更改。 在审查拉取请求中的文件时,可对特定更改进行个别评论。 在完成审查每个文件后,您可以将该文件标记为已查看。 这会折叠文件,帮助您识别还需要审查的文件。 拉取请求标头中的进度条显示您查看过的文件数。 在按需要审查多个文件后,您可以在摘要评论中提交审查,以批准拉取请求或申请其他更改。

提示:使用搜索限定符 review-requested:[USERNAME]team-review-requested:[TEAMNAME] 可查找请求您或您所属团队审查的拉取请求。更多信息请参阅“搜索议题和拉取请求”。

开始审查

  1. 在仓库名称下,单击 Pull requests(拉取请求)

    议题和拉取请求选项卡选择

  2. 在拉取请求列表中,单击要审查的拉取请求。

  3. 在拉取请求上,单击 Files changed(文件已更改)

    Files changed(文件已更改)选项卡

  4. 将鼠标悬停在要添加评论的代码行上方,然后单击蓝色的评论图标。

    蓝色评论图标

  5. 在 comment(评论)字段中,键入您的评论。

    评论字段

  6. (可选)要建议对某行进行特定更改,请单击 ,然后编辑建议块内的文本。

    建议块

  7. 完成后,单击 Start a review(开始审查)。 如果已开始审查,您可以单击 Add review comment(添加审查注释)

    开始审查按钮

提交审查之前,您的行注释为待处理状态并且仅对您可见。 您可以在提交审查之前随时编辑待处理的注释。 要取消待处理的审查(包括所有其待处理的注释),请在 Conversation(对话)选项卡中向下滚动到时间表的末尾,然后单击 Cancel review(取消审查)

取消审查按钮

将文件标记为已查看

在完成审查文件后,您可以将文件标记为已查看,该文件将会收起。 如果查看过的文件有更改,将会取消已查看的标记。

  1. 在拉取请求上,单击 Files changed(文件已更改)

    Files changed(文件已更改)选项卡

  2. 在完成审查的文件的标头右侧,选择已查看

    已查看复选框

提交审查

完成审查拉取请求中需要查看的所有文件后,提交您的审查。

  1. 在拉取请求上,单击 Files changed(文件已更改)

    Files changed(文件已更改)选项卡

  2. 在已更改代码的上方,单击 Review changes(审查更改)

    Review changes(审查更改)按钮

  3. 键入评论以总结您对提议更改的反馈。

    审查摘要评论窗口

  4. 选择您想要留下的审查类型:

    具有审查选项的单选按钮

    • 选择 Comment(注释)留下一般反馈而不明确批准更改或请求其他更改。
    • 选择 Approve(批准)提交反馈并批准合并拉取请求中提议的更改。
    • 选择 Request changes(请求更改)提交在拉取请求合并之前必须解决的反馈。
  5. 单击 Submit review(提交审查)

提示

  • 在启用了必需审查时,如果对仓库具有写入、管理员或所有者权限的协作者提交了请求更改的审查,则在该协作者提交另一个批准拉取请求更改的审查之前,该拉取请求无法合并。
  • 即使尚未收到批准审查,或者请求更改的审查者已离开组织或不可用,仓库所有者和管理员也可以合并拉取请求。
  • 在同时启用了必需审查和取消旧审查时,如果一个代码修改提交被推送到经批准的拉取请求的分支中,则批准将被取消。该拉取请求必须再次获得审查和批准后才能进行合并。
  • 当多个打开的拉取请求都有一个指向同一提交的头部分支时,如果其中有一个或多个拉取请求的审查为待定或拒绝,则无法合并它们。

延伸阅读

问问别人

找不到要找的内容?

联系我们