PyCharm 2025.3 Help

审查传入的 GitLab 合并请求

GitLab 合并请求 用于开源项目或部分企业工作流,以管理来自贡献者的更改,并在合并这些更改之前发起代码评审。

您可能会收到来自同事或其他贡献者的代码更改评审请求。 作为合并请求评审者,您可以直接在 PyCharm 中提供反馈:

  1. 合并请求 工具窗口中, 选择一个待评审请求

  2. 提交您的评论和建议

  3. 合并或关闭该合并请求

管理传入的合并请求

如果您是项目维护者,并且为项目配置了 GitLab 远程仓库,您可以直接在 PyCharm 中查看并管理传入的合并请求。

要打开 合并请求 工具窗口,请在左侧工具窗口栏中点击 GitLab 图标

合并请求筛选器

或者,在主菜单中转到 Git | GitLab | 查看合并请求

使用 合并请求 工具窗口可:

  • 筛选请求 ,按状态、作者、受让人、评审者和标签。

  • 跳转到 GitLab 上的合并请求 :在合并请求上点击右键,然后在上下文菜单中选择 在 GitLab 上打开合并请求

在列表中双击某个合并请求后,您可以看到概览和时间线选项卡。

带突出显示选项的合并请求概览

在此视图中,您可以:

  • 查看时间线 ,以跟踪所选合并请求的进展,并为整个合并请求留下评论。

  • 选择特定提交 ,以筛选更改列表。

  • 基于传入更改创建本地分支 :打开合并请求,点击包含传入更改的分支,然后在上下文菜单中选择 检出 'branch name'

  • 调查与分支相关的更改 ,在 Git 工具窗口的 日志 选项卡中:打开合并请求,点击包含传入更改的分支,然后在上下文菜单中选择 在 Git 日志中显示 'branch name'

    这将帮助您浏览与该合并请求相关的代码,确保项目可以构建且测试通过。

要了解更多选项,请参阅 对合并请求提供反馈

对合并请求提供反馈

当有需要您留意的更改时, GitLab 工具窗口会显示白点,未查看的合并请求会以蓝点标记。

  1. 在主菜单中,转到 Git | GitLab | 查看合并请求

  2. 在合并请求列表中,选择您要处理的请求并双击。

    PyCharm 会打开所选合并请求的概览。

    合并请求概览
    • 在标题旁会显示合并请求编号。 如果您想在 GitLab 上打开该合并请求,请点击该编号。

    • 点击 查看时间线 按钮可打开时间线,并为整个合并请求留下评论。

    • 如果一个合并请求包含多个提交,您可以在 更改来源 下拉菜单中选择某个提交以聚焦到该提交。 按上下按钮在各个提交之间导航。

    • 在任意文件上点击右键以打开该文件的上下文菜单。

    • 如果评审者留下了任何评论或建议,文件列表中会显示一个评论计数器,表示评论数量。

  3. 要开始您的评审,请点击包含传入更改的分支,并在上下文菜单中选择 检出 'branch name'

    检出包含传入更改的分支

    通过检出该分支,您可以获得完整上下文以测试传入更改并检查其工作方式。

    检出成功后,PyCharm 会启动 评审模式。 这意味着,您不仅可以在 Diff 选项卡(Ctrl+D )中查看突出显示的更改和评论,还可以直接在编辑器(F4 )中查看。

  4. 选择您要调查的文件,在其上点击右键,并在上下文菜单中选择 跳转到源代码 F4

    在打开的文件中,装订区域中的粉色标记表示可供评审的更改和评论。

    点击装订区域中的评论图标可隐藏或打开评论。

    评审模式中的更改和评论

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

    评审模式 — 查看差异
  5. 将鼠标悬停在装订区域上并点击 以留下评论。

    包含建议的评论字段
    • 选择 添加评论 可立即发布评论并通知其他评审者。

    • 选择 保存为草稿 以添加多个评论。

      在提交评审之前,您的评论会标记为 待处理 ,且您可以编辑或删除它们。

  6. 要在整个合并请求上添加总体评论,请打开该合并请求的时间线视图。

  7. 在合并请求详情选项卡中点击 提交审查 以提交评审或批准合并请求。

    提交评审对话框

    选择一个可能的结果:

    • 批准 :批准合并更改。

    • 提交 :在不批准的情况下提交反馈。

    如果您改变主意,可以稍后点击 撤销批准 按钮。

如果合并请求的工作已完成,您可以在同一合并请求详情选项卡中将其合并或关闭。

合并或关闭传入的合并请求

如果仓库所有者已为您分配必要权限,在提交评审并解决所有问题后,您可以合并或关闭该合并请求。

  1. 在主菜单中,转到 Git | GitLab | 查看合并请求

  2. 在合并请求列表中,选择您要处理的请求并双击。

  3. 在概览底部,有一个带有合并选项的按钮,不同选项取决于评审流程阶段和您的权限。

    • 如果您在评审后已批准更新,可点击 合并 来合并该合并请求。

      如需更多合并选项,点击 向下箭头 并选择 压缩并合并 ,在合并前将包含您更改的提交压缩为一个。

    • 点击 更多 ,并选择 请求审查 (如果您需要对此合并请求的其他意见),或 关闭合并请求 (如果您不想合并它)。

最后修改日期: 2025年 12月 2日