审查传入的 GitLab 合并请求
GitLab 合并请求 用于开源项目或部分企业工作流,以管理来自贡献者的更改,并在合并这些更改之前发起代码评审。
您可能会收到同事或协作者发来的代码更改审查请求。 作为合并请求评审者,您可以直接在 PyCharm 中提供反馈:
选择一个待处理的审查请求 在 合并请求 工具窗口中。
管理传入的合并请求
如果您是项目维护者,并且为项目配置了 GitLab 远程仓库,您可以直接在 PyCharm 中查看并管理传入的合并请求。
要打开 合并请求 工具窗口,请在左侧的工具窗口栏中点击 。

或者,转到主菜单中的 。
使用 合并请求 工具窗口可:
筛选请求 ,按状态、作者、受让人、评审者和标签。
跳转到 GitLab 上的合并请求 :在合并请求上点击右键,然后在上下文菜单中选择 在 GitLab 上打开合并请求。
在列表中双击某个合并请求后,您可以看到概览和时间线选项卡。

在此视图中,您可以:
查看时间线 ,以跟踪所选合并请求的进展,并为整个合并请求留下评论。
选择特定提交 以筛选更改列表。
基于传入更改创建本地分支 :打开合并请求,点击包含传入更改的分支,然后在上下文菜单中选择 检出 'branch name'。
调查与分支相关的更改 ,在 Git 工具窗口的 日志 选项卡中:打开合并请求,点击包含传入更改的分支,然后在上下文菜单中选择 在 Git 日志中显示 'branch name'。
这将帮助您浏览与该合并请求相关的代码,确保项目可以构建且测试通过。
要了解更多选项,请参阅 对合并请求提供反馈。
对合并请求提供反馈
当有需要您留意的更改时, GitLab 工具窗口会显示白点,未查看的合并请求会以蓝点标记。
在主菜单中,转到 。
在合并请求列表中,选择您要处理的请求并双击。
PyCharm 会打开所选合并请求的概览。

在标题旁会显示合并请求编号。 如果您想在 GitLab 上打开该合并请求,请点击该编号。
点击 查看时间线 按钮以打开时间线,并为整个合并请求留下评论。
如果一个合并请求包含多个提交,您可以在 更改来源 下拉菜单中选择某个提交以聚焦到该提交。 按上下按钮在各个提交之间导航。
右键点击任意文件以打开其上下文菜单。
如果评审者留下了任何评论或建议,文件列表中会显示一个评论计数器,表示评论数量。
要开始审查,请点击包含传入更改的分支,然后在上下文菜单中选择 检出 'branch name'。

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

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

将鼠标悬停在装订区域上并点击
以留下评论。

选择 添加评论 可立即发布评论并通知其他评审者。
选择 保存为草稿 以添加多个评论。
在提交审查之前,您的评论将标记为 待处理 ,且您可以对其进行编辑或删除。
要对多行进行评论,可以点击
并拖动蓝色边框覆盖所需范围,或先高亮显示文本后再点击
。
要在评论中包含附件,请将文件直接拖到评论框中,或在框内右键单击并选择
上传文件。 如果你已经将文件复制到剪贴板,还可以在上下文菜单中选择 粘贴。 文件将根据 GitLab API 的处理方式显示为内联图片或超链接。
可在顶部工具栏中使用
/
,或按下 Ctrl+Alt+Up/Ctrl+Alt+Down 在评论之间导航。
要在整个合并请求上添加总体评论,请打开该合并请求的时间线视图。
在合并请求详情选项卡中点击 提交审查 以提交评审或批准合并请求。

选择一个可能的结果:
批准 :批准合并更改。
提交 :在不批准的情况下提交反馈。
如果您改变主意,可以稍后点击 撤销批准 按钮。
如果合并请求的工作已完成,您可以在同一合并请求详情选项卡中将其合并或关闭。
合并或关闭传入的合并请求
如果仓库所有者已为您分配必要权限,在提交评审并解决所有问题后,您可以合并或关闭该合并请求。
在主菜单中,转到 。
在合并请求列表中,选择您要处理的请求并双击。
在概览底部,有一个带有合并选项的按钮,不同选项取决于评审流程阶段和您的权限。
在审查后如果您已批准更新,您可以点击 合并 来合并该合并请求。
如需更多合并选项,点击
并选择 压缩并合并 ,在合并前将包含您更改的提交压缩为一个。
点击
更多 ,并选择 请求评审 (如果您需要对此合并请求的其他意见),或 关闭合并请求 (如果您不想合并它)。