合并冲突

合并冲突发生在合并请求的两个分支(源分支和目标分支)对相同代码行进行了不同的修改。在大多数情况下,GitLab 能够自动合并这些更改,但当出现冲突时,你需要决定保留哪些更改。

要解决有冲突的合并请求,你必须执行以下操作之一:

  • 创建一个合并提交(merge commit)。
  • 通过变基(rebase)解决冲突。

Merge request widget

极狐GitLab 通过在源分支中创建一个合并提交来解决冲突,而不将其合并到目标分支。然后,你可以审核和测试该合并提交,以确保它不包含任何意外的更改,并且不会破坏构建。

理解冲突块

当 Git 检测到一个需要你决定的冲突时,它会使用冲突标记来标记冲突块的开始和结束:

  • <<<<<<< HEAD 标记冲突块的开始。 你的更改会显示在这里。
  • ======= 标记你的更改的结束。 目标分支中的最新更改会显示在这里。
  • >>>>>>> 标记冲突的结束。

要解决冲突,删除:

  • 你不想保留的冲突行版本。
  • 三个冲突标记:开始标记、结束标记,以及两个版本之间的 ======= 行。

你可以在用户界面中解决的冲突

你可以在 GitLab 用户界面中解决合并冲突,如果冲突文件符合以下条件:

  • 是非二进制文本文件。
  • 文件大小小于 200 KB,且已添加冲突标记。
  • 使用 UTF-8 兼容编码。
  • 不包含冲突标记。
  • 在两个分支中的路径相同。

如果文件不符合这些条件,你必须手动解决冲突。

解决冲突的方法

极狐GitLab 在用户界面中显示了可供解决的冲突,您也可以使用以下方法解决冲突:

  • 交互模式:适用于只需要选择保留哪一行版本的冲突。
  • 内联编辑器:适用于需要手动编辑以合并更改的复杂冲突。
  • 命令行:提供对复杂冲突的完全控制。有关更多信息,请参阅 从命令行解决冲突.。

交互模式

交互模式将目标分支合并到源分支,并根据你选择的更改进行合并。

使用交互模式解决合并冲突的步骤:

  1. 在左侧边栏,选择 搜索或前往 并找到你的项目。
  2. 选择 代码 > 合并请求 并找到相应的合并请求。
  3. 选择 概述,然后滚动到合并请求报告部分。
  4. 找到合并冲突消息,并选择 解决冲突。 GitLab 显示一份包含合并冲突的文件列表。冲突的行会被高亮显示。

    conflict section

  5. 对于每个冲突,选择 使用我们的版本使用他们的版本 来标记你希望保留的冲突行版本。这个决定被称为 “解决冲突”。
  6. 当你解决所有冲突后,输入 提交信息
  7. 选择 提交到源分支

内联编辑器

一些合并冲突更加复杂,你需要手动编辑行来解决它们。

合并冲突解决编辑器帮助你在 GitLab 中解决这些冲突:

  1. 在左侧边栏,选择 搜索或前往 并找到你的项目。
  2. 选择 代码 > 合并请求 并找到相应的合并请求。
  3. 选择 概述,然后滚动到合并请求报告部分。
  4. 找到合并冲突消息,并选择 解决冲突。 GitLab 显示一份包含合并冲突的文件列表。
  5. 找到需要手动编辑的文件,并滚动到冲突块。
  6. 在该文件的标题栏中,选择 内联编辑 来打开编辑器。在这个例子中,冲突块从第 1350 行开始,到第 1356 行结束:

    Merge conflict editor

  7. 解决冲突后,输入 提交信息
  8. 选择 提交到源分支

变基

如果你的合并请求卡在 检查自动合并能力 的消息上,你可以:

要排查 CI/CD 管道问题,请参阅 调试 CI/CD 管道

使用快速操作进行变基

你可以通过 GitLab UI 使用 /rebase 快速操作 来进行变基。

先决条件:

使用快速操作进行变基的步骤:

  1. 进入你的合并请求。
  2. 在评论中输入 /rebase
  3. 选择 评论

极狐GitLab 将调度并执行该分支与默认分支的变基操作。

相关主题