# 审查传入的 GitLab 合并请求

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> GitLab 设置：  `设置 | 版本控制 | GitLab`
>
>
>
> 所需插件：   Git   和   GitLab  （默认捆绑并启用）

[GitLab 合并请求](https://docs.gitlab.com/ee/user/project/merge_requests/) 用于开源项目或某些企业工作流，以管理来自贡献者的更改，并在合并此类更改之前发起代码审查。

您可能会收到同事或协作者发来的代码更改审查请求。 作为合并请求审查者，您可以直接在 IntelliJ IDEA 中提供反馈：

1.  在   合并请求   工具窗口中 [选择待处理的审查请求](#gitlab-merge-requests-tools)。

2.  [提交注释和建议](#review-merge-request)。

3.  [合并或关闭该合并请求](#merge-or-close-an-incoming-merge-request)。

## 管理传入的合并请求

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

要打开   合并请求   工具窗口，请在左侧的工具窗口栏中点击 ![GitLab 图标](https://resources.jetbrains.com/help/img/idea/2026.3/vcs-gitlab.org.jetbrains.plugins.gitlab.expui.gitLabToolWindow.svg)。

![合并请求筛选器](https://resources.jetbrains.com/help/img/idea/2026.3/merge_request_filters.png)

或者，前往主菜单中的  `Git | GitLab | 查看合并请求` 。

使用   合并请求   工具窗口来：

* 请求筛选器 可按状态、作者、被指派者、审查者和标签进行筛选。

* 跳转到 GitLab 上的合并请求 ：右键点击合并请求，然后从上下文菜单中选择 在 GitLab 上打开合并请求 。

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

![带突出显示选项的合并请求概览](https://resources.jetbrains.com/help/img/idea/2026.3/merge_request_options.png)

在此视图中，可以：

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

* 选择特定提交 作为更改列表的筛选器。

* 基于传入更改创建本地分支 ：打开合并请求，点击带有传入更改的分支，并在上下文菜单中选择 检出 'branch name' 。

* 在 Git 工具窗口的 日志 选项卡中 调查与分支相关的更改 ：打开合并请求，点击包含传入更改的分支，然后在上下文菜单中选择 在 Git Log 中显示 'branch name' 。 这有助于浏览与此合并请求相关的代码，确保项目能够构建且测试通过。

要详细了解更多选项，请参阅 [对合并请求提供反馈](#review-merge-request)。

> **Tip:**
> 为确保您始终掌握最新的合并请求信息，请按下 `Ctrl+F5` (Windows), `⌘ R` (macOS), `⌃ F5` (IntelliJ IDEA Classic (macOS)), `⌘ R` (macOS System Shortcuts), `Ctrl+F5` (XWin), `Ctrl+F5` (GNOME), `Ctrl+5` (KDE), `Ctrl+F5` (Emacs), `Ctrl+F5` (Sublime Text), `⌘ R` (Sublime Text (macOS)), `Ctrl+Alt+R` (Visual Studio), `⌘ ⌥ R` (Visual Studio (macOS)), `Ctrl+F5` (NetBeans), `Ctrl+F5` (Eclipse), `Ctrl+F5` (Eclipse (macOS))。 或者，右键点击所需的 merge request 并选择   刷新列表  。

## 对合并请求提供反馈

当有需要注意的更改时，白色圆点会标记   GitLab   工具窗口，未查看的合并请求会以蓝色圆点标记。

Procedure:

1. 在主菜单中，前往  `Git | GitLab | 查看合并请求` 。

2. 在合并请求列表中，选择要处理的请求并点击两次。

IntelliJ IDEA 将打开所选合并请求的概览。

![合并请求概览](https://resources.jetbrains.com/help/img/idea/2026.3/merge_request_overview.png)

* 标题旁边有一个合并请求编号。 如果您想在 GitLab 上打开合并请求，请点击。

* 点击 视图时间线 按钮以打开时间线，并为整个合并请求留下评论。

* 如果合并请求包含多个提交，请在 更改来源 下拉菜单中选择特定提交以聚焦该提交。 通过按上下按钮在提交之间导航。

* 右键点击任意文件以打开此文件的上下文菜单。

* 如果审查者留下了任何注释或建议，文件列表中会显示一个包含注释数量的计数器。

3. 要开始审查，请点击包含传入更改的分支，然后在上下文菜单中选择   检出 'branch name'  。

![检出包含传入更改的分支](https://resources.jetbrains.com/help/img/idea/2026.3/local_branch_from_mr.png)

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

成功检出后，IntelliJ IDEA 会启动  审查模式 。 这意味着不仅可以在差异选项卡（ `Ctrl+D` (Windows), `⌘ D` (macOS), `⌘ D` (IntelliJ IDEA Classic (macOS)), `⌘ D` (macOS System Shortcuts), `Ctrl+D` (XWin), `Ctrl+D` (GNOME), `Ctrl+D` (KDE), `Ctrl+D` (Emacs), `Ctrl+D` (Sublime Text), `⌘ D` (Sublime Text (macOS)), `Ctrl+D` (Visual Studio), `⌘ D` (Visual Studio (macOS)), `Ctrl+D` (NetBeans), `Ctrl+D` (Eclipse), `⌘ D` (Eclipse (macOS))）中看到高亮显示的更改和注释，还可以直接在编辑器（ `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))）中看到。

> **Note:**
> 可以通过点击编辑器右上角的   评审模式   来配置审查模式或将其禁用。
>
>
>
> ![带有选项的弹出窗口](https://resources.jetbrains.com/help/img/idea/2026.3/gl_disable_review_mode.png)
>
> 还可以自定义指示更改行颜色，在  `设置 | 编辑器 | 配色方案 | 代码审查` 中。

4. 选择要调查的文件，右键点击该文件，然后从上下文菜单中选择   跳转到源   `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))。

在打开的文件中，装订区域中的粉色标记表示可供审查的更改和注释。

点击装订区域中的注释图标会隐藏或打开注释。

![审查模式中的更改和注释](https://resources.jetbrains.com/help/img/idea/2026.3/gh_review_mark_gutter.png)

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

![审查模式 - 查看差异](https://resources.jetbrains.com/help/img/idea/2026.3/github_pull_request_review_view_diff.png)

5. 将鼠标悬停在装订区域上，然后点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.add.svg) 以留下注释。

![带有建议的评论字段](https://resources.jetbrains.com/help/img/idea/2026.3/gl_add_comment.png)

* 选择 添加注释 立即发布评论，并通知其他审阅者。

* 选择 保存为草稿 添加多条注释。 在提交审查之前，注释会标记为 待处理 ，并且可以编辑或删除。

要对多行添加注释，可以点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.add.svg) 并拖动蓝色边框以覆盖所需范围，或者先高亮显示文本，然后点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.add.svg)。

> **Note:**
> GitLab 18.6 及之后版本支持多行注释。

要提及用户，请输入  `@` ，然后从建议弹窗中选择所需用户名。 添加提及后，可点击其在浏览器中打开该用户的个人资料。

要在注释中包含附件，请将文件直接拖入注释框，或在框内右键点击并选择 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.upload.svg)   上传文件  。 如果已有文件复制到剪贴板，也可以在上下文菜单中选择   粘贴  。 根据 GitLab API 处理文件的方式，它将显示为内联图像或超链接。

使用上方工具栏中的 ![“向上”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.up.svg) / ![“向下”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.down.svg)，或按 `Ctrl+Alt+Up` (Windows), `⌘ ⌥ ↑` (macOS), `⌘ ⌥ ↑` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ↑` (macOS System Shortcuts), `Ctrl+Alt+Up` (XWin), `Alt+Shift+Up` (GNOME), `Ctrl+Alt+Up` (KDE), `Ctrl+Alt+Up` (Emacs), `Ctrl+Alt+Up` (Sublime Text), `Ctrl+Alt+Up` (Sublime Text (macOS)), `Ctrl+Alt+Up` (Visual Studio), `⌘ ⌥ ↑` (Visual Studio (macOS)), `Ctrl+Alt+Up` (NetBeans), `Ctrl+Alt+Up` (Eclipse), `Ctrl+Alt+Up` (Eclipse (macOS)) / `Ctrl+Alt+Down` (Windows), `⌘ ⌥ ↓` (macOS), `⌘ ⌥ ↓` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ↓` (macOS System Shortcuts), `Ctrl+Alt+Down` (XWin), `Alt+Shift+Down` (GNOME), `Ctrl+Alt+Down` (KDE), `Ctrl+Alt+Down` (Emacs), `Ctrl+Alt+Down` (Sublime Text), `Ctrl+Alt+Down` (Sublime Text (macOS)), `Ctrl+Alt+Down` (Visual Studio), `⌘ ⌥ ↓` (Visual Studio (macOS)), `Ctrl+Alt+Down` (NetBeans), `Ctrl+Alt+Down` (Eclipse), `Ctrl+Alt+Down` (Eclipse (macOS))，在注释之间导航。

> **Note:**
> 如果没有留下注释的选项，请检查对 GitLab 仓库的访问权限。

6. 要对整个合并请求添加总体注释，请打开此合并请求的时间线视图。

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

![提交评论对话框](https://resources.jetbrains.com/help/img/idea/2026.3/gl_submit_review.png)

选择一种可能的结果：

* 批准 ：批准合并更改。

* 提交 ：提交您的反馈无需批准。

如果您改变了主意，您之后可以点击   撤销批准  按钮。

如果与合并请求的工作已经完成，您可以在相同的合并请求详细信息标签中进行合并或关闭。

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

如果存储库所有者为您分配了所需权限，在提交审查并解决所有问题后，您可以合并或关闭该合并请求。

Procedure:

1. 在主菜单中，前往  `Git | GitLab | 查看合并请求` 。

2. 在合并请求列表中，选择要处理的请求并点击两次。

3. 在概览底部，有一个合并选项按钮，其选项会根据审查流程的阶段和您的权限而有所不同。

* 在审查后如果您已批准更新，您可以点击 合并 来合并该合并请求。 如需更多合并选项，请点击 ![向下箭头](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.chevronDown.svg) 并选择 压缩并合并 ，以便在合并之前将包含更改的提交压缩（合并提交）为一个提交。

* 点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moreVertical.svg) 更多 ，如果需要此合并请求的其他意见，请选择 请求评审 ；如果不想合并，请选择 关闭合并请求 。

请观看此视频教程，了解如何处理 GitLab 合并请求：

[Video](https://www.youtube.com/v/I_k9v9bBaCA)

