关于拉取请求审查
审查允许协作者评论拉取请求中提议的更改、审批更改或在拉取请求合并之前请求进一步更改。 仓库管理员可要求所有拉取请求在合并之前获得批准。
本文内容:
关于拉取请求审查
在拉取请求打开后,具有读取权限的任何人都可以审查和评论其提议的更改。 更多信息请参阅“审查拉取请求中提议的更改”。
仓库所有者和协作者可向具体的个人申请拉取请求审查。 组织成员也可向具有仓库读取权限的团队申请拉取请求审查。 更多信息请参阅“申请拉取请求审查”。
审查允许讨论提议的更改,帮助确保更改符合仓库的参与指南及其他质量标准。 您可以在 CODEOWNERS 文件中定义哪些个人或团队拥有代码的特定类型或区域。 当拉取请求修改定义了所有者的代码时,该个人或团队将自动被申请为审查者。 更多信息请参阅“关于代码所有者”。
审查有三种可能的状态:
- 评论:提交一般反馈,但不明确批准更改或申请其他更改。
- 批准:提交反馈并批准合并拉取请求中提议的更改。
- 申请更改:提交在拉取请求合并之前必须解决的反馈。
提示:
- 在启用了必需审查时,如果对仓库具有写入、管理员或所有者权限的协作者提交了请求更改的审查,则在该协作者提交另一个批准拉取请求更改的审查之前,该拉取请求无法合并。
- 即使尚未收到批准审查,或者请求更改的审查者已离开组织或不可用,仓库所有者和管理员也可以合并拉取请求。
- 在同时启用了必需审查和取消旧审查时,如果一个代码修改提交被推送到经批准的拉取请求的分支中,则批准将被取消。该拉取请求必须再次获得审查和批准后才能进行合并。
- 当多个打开的拉取请求都有一个指向同一提交的头部分支时,如果其中有一个或多个拉取请求的审查为待定或拒绝,则无法合并它们。
您可以在“对话”时间表中查看拉取请求收到的所有审查,也可在拉取请求的合并框中按仓库所有者和协作者查看审查。
提示:使用搜索限定符 review-requested:[USERNAME]
或 team-review-requested:[TEAMNAME]
可查找请求您或您所属团队审查的拉取请求。更多信息请参阅“搜索议题和拉取请求”。
必要的审查
仓库管理员可要求所有拉取请求在收到特定数量的批准审查(对仓库拥有写入或管理员权限的人或者指定代码所有者的审查)之后,才能合并到受保护分支。更多信息请参阅“关于受保护分支”。
启用必需审查后,任何对仓库拥有访问权限的人都可以批准拉取请求中的更改。但是,在所需数量的审查者(对仓库拥有写入或管理员权限)审查批准您的拉取请求更改之前,您无法合并您的拉取请求。有关仓库权限级别的详细信息,请参阅“组织的仓库权限级别”。如果要求指定的代码所有者审查,并且拉取请求会影响指定所有者的代码,则必须获得该所有者的批准。
更多信息请参阅“关于拉取请求的必需审查”。
提示:如有必要,对仓库具有管理员或写入权限的人员可以忽略拉取请求审查。 更多信息请参阅“忽略拉取请求审查”。
延伸阅读
- "审查拉取请求中提议的更改"
- "启用拉取请求的必需审查"
- "查看拉取请求审查"
- "设置仓库贡献者的指导方针"