审查传入的 GitHub 拉取请求
拉取请求用于开源项目或一些企业工作流程中,以管理贡献者的更改,并在这些更改合并之前启动代码审查。
您可能会收到同事或协作者发来的代码更改审查请求。 作为拉取请求审查者,可以直接在 IntelliJ IDEA 中提供反馈:
在 拉取请求合集更新提醒触发了审查通知。啊是否 need? 工具窗口中 选择待处理的审查请求。
管理传入的 pull requests
如果您是项目维护者,并且为您的项目配置了 GitHub 远程仓库,您可以直接在 IntelliJ IDEA 中查看和管理传入的拉取请求。
要打开 拉取请求合集更新提醒触发了审查通知。啊是否 need? 工具窗口,请在主菜单中选择 。

在 拉取请求合集更新提醒触发了审查通知。啊是否 need? 工具窗口中,可以:
按状态、作者、标签、受托人和审查状态筛选请求。
排序拉取请求,依据其活动状态:最新、最旧、注释最多或最少、最近更新或最久未更新。
跳转到 GitHub 上的拉取请求 :选择一个拉取请求并从上下文菜单中选择 在浏览器中查看拉取请求。
在列表中点击某个拉取请求两次时,可以看到概览和时间线选项卡。

在此视图中,可以:
查看时间线 ,以跟踪所选拉取请求的进展。
选择特定提交作为更改列表的筛选器。
基于传入更改创建本地分支 :打开拉取请求,点击带有传入更改的分支,并在上下文菜单中选择 检出 'branch name'。
要详细了解更多选项,请参阅 审核 pull request。
审核 pull request
当有需要您注意的更改时, 拉取请求合集更新提醒触发了审查通知。啊是否 need? 工具窗口将会出现一个白色点,未查看的 pull requests 将用蓝点标记。

在主菜单中,前往 。
在拉取请求列表中,选择要处理的拉取请求并点击两次。
IntelliJ IDEA 会打开所选拉取请求的概览。

标题旁边是拉取请求编号。 如果您想在 GitHub 上打开 pull request,请点击此处。
点击 视图时间线 后,会打开一个新标签页,其中显示拉取请求的进度以及整个拉取请求的高级别注释。
要筛选更改文件的列表,请在 更改来源 中选择要调查的提交。
右键点击任意文件以打开此文件的上下文菜单。
如果有任何注释或建议,文件列表中会显示一个包含注释数量的计数器。
要开始审查,请点击包含传入更改的分支,然后在上下文菜单中选择 检出 'branch name'。

通过检出分支,可以获得完整上下文来测试传入更改并检查其工作方式。
成功检出后,IntelliJ IDEA 会启动 审查模式。 这意味着不仅可以在差异选项卡(Ctrl+D )中看到高亮显示的更改和注释,还可以直接在编辑器(F4 )中看到。
选择要调查的文件,右键点击该文件,然后从上下文菜单中选择 跳转到源 F4。
在打开的文件中,装订区域中的粉色标记表示可供审查的更改和注释。
点击装订区域中的注释图标会隐藏或打开注释。

点击粉色标记会显示一个展示原始代码的弹出窗口。

将鼠标悬停在装订区域上,然后点击
以留下注释。

选择 添加单条注释 立即发布评论,并通知其他审阅者。
选择 开始审查 添加多条注释。
在提交审查之前,注释会标记为 待处理 ,并且可以编辑或删除。

要对多行添加注释,可以点击
并拖动蓝色边框以覆盖所需范围,或者先高亮显示文本,然后点击
。
对于建议,请添加已包装在 Markdown 代码块中的代码版本,并将
建议指定为语言。```suggestion Your suggestion for this code line ```使用上方工具栏中的
/
,或按 Ctrl+Alt+Up/Ctrl+Alt+Down ,在注释之间导航。
要提及用户,请输入
@,然后从建议弹窗中选择所需用户名。 添加提及后,可点击其在浏览器中打开该用户的个人资料。准备好完成审查后,请在拉取请求概览中点击 提交。

或者,打开 VCS 微件并点击 提交评审。
选择一种可能的结果:
批准 :批准合并更改。
请求更改 :要提交反馈,pull request 作者必须在合并之前应用建议的更改。
注释 :提交评论无需审批。
合并或关闭传入的拉取请求
如果您拥有仓库的推送访问权限,在提交审查并解决所有问题后,可以合并或关闭拉取请求。
在主菜单中,前往 。
在拉取请求列表中,选择要处理的拉取请求并点击两次。
在概览底部,有一个包含合并选项的按钮,这些选项会根据审查流程的阶段和推送访问权限而有所不同。

如果您在审核后批准了更新,您可以通过点击 合并 来合并 pull request。
如需更多合并选项,请点击
并选择 压缩并合并 以在合并之前将您的更改的提交压缩为一个,或 变基 以从拉取请求分支变基提交并将其添加到基分支。
点击
更多 ,如果需要对此 pull request 请求另一个意见,请选择 请求评审 ;如果不想合并,请选择 关闭拉取请求。
如果您准备在不提交审查的情况下合并 pull request,请在 pull request 概览中点击
并选择 合并、 压缩并合并 或 变基。

拉取请求合并后,可以在带有拉取请求时间线的选项卡中删除已合并的分支。
如有必要,可以使用删除后出现在同一时间线视图中的浏览器链接来恢复已删除的分支。