审查拉取请求中的建议更改
在拉取请求中,您可以审查和讨论提交、更改的文件以及基本和比较分支中文件之间的区别(或“差异”)。
本文内容
关于审查拉取请求
您可以在拉取请求中每次审查一个文件的更改。 在审查拉取请求中的文件时,可对特定更改进行个别评论。 在按需要审查多个文件后,您可以在摘要评论中提交审查,以批准拉取请求或申请其他更改。
提示:使用搜索限定符 review-requested:[USERNAME]
或 team-review-requested:[TEAMNAME]
可查找请求您或您所属团队审查的拉取请求。 更多信息请参阅“搜索议题和拉取请求”。
开始审查
-
在仓库名称下,单击 Pull requests(拉取请求)。
-
在拉取请求列表中,单击要审查的拉取请求。
-
在拉取请求中,单击 Files changed(文件已更改)。
-
将鼠标悬停在您要添加评论的代码行上,然后单击蓝色评论图标。
-
在评论字段中输入您的评论。
- 完成后,单击 Start a review(开始审查)。 如果已开始审查,您可以单击 Add review comment(添加审查注释)。
提交审查之前,您的行注释为待处理状态并且仅对您可见。 您可以在提交审查之前随时编辑待处理的注释。 要取消待处理的审查(包括所有其待处理的注释),请在 Conversation(对话)选项卡中向下滚动到时间表的末尾,然后单击 Cancel review(取消审查)。
提交审查
完成审查拉取请求中需要查看的所有文件后,提交您的审查。
-
在拉取请求中,单击 Files changed(文件已更改)。
-
在更改的代码上方,单击 Review changes(审查更改)。
-
输入评论,概述您对拟议更改的反馈。
-
选择您想要留下的审查类型:
- 选择 Comment(注释)留下一般反馈而不明确批准更改或请求其他更改。
- 选择 Approve(批准)提交反馈并批准合并拉取请求中提议的更改。
- 选择 Request changes(请求更改)提交在拉取请求合并之前必须解决的反馈。
-
单击 Submit review(提交审查)。
提示:
- 如果启用了必需的审查,并且对仓库具有写入、管理员或所有者访问权限的协作者提交请求更改的审查,则在同一协作者提交另一次要求批准拉取请求中更改的审查之前,拉请求不能合并。
- 即使没有获得批准审查,或者请求更改的审查者离开了组织或者联系不上,仓库所有者和管理员也可合并拉取请求。
- 如果同时启用了必需审查和过期审查,并且代码修改提交已推送到批准的拉取请求分支,则批准将予驳回。 拉取请求必须经过再次审查和批准才可合并。
- 当多个打开的拉取请求时分别有指向同一提交的头部分支时,如果一个或两者有待定或被拒绝的审查,您将无法合并它们。
延伸阅读
- “关于拉取请求审查”
- "关于拉取请求的必要审查"
- “批准需要审查的拉取请求”
- "评论拉取请求"
- "按审查状态过滤拉取请求"