合并冲突
合并冲突发生在合并请求的两个分支(源分支和目标分支)对相同代码行进行了不同的修改。在大多数情况下,GitLab 能够自动合并这些更改,但当出现冲突时,你需要决定保留哪些更改。
要解决有冲突的合并请求,你必须执行以下操作之一:
- 创建一个合并提交(merge commit)。
- 通过变基(rebase)解决冲突。
极狐GitLab 通过在源分支中创建一个合并提交来解决冲突,而不将其合并到目标分支。然后,你可以审核和测试该合并提交,以确保它不包含任何意外的更改,并且不会破坏构建。
理解冲突块
当 Git 检测到一个需要你决定的冲突时,它会使用冲突标记来标记冲突块的开始和结束:
-
<<<<<<<
HEAD 标记冲突块的开始。 你的更改会显示在这里。 -
=======
标记你的更改的结束。 目标分支中的最新更改会显示在这里。 -
>>>>>>>
标记冲突的结束。
要解决冲突,删除:
- 你不想保留的冲突行版本。
- 三个冲突标记:开始标记、结束标记,以及两个版本之间的
=======
行。
你可以在用户界面中解决的冲突
你可以在 GitLab 用户界面中解决合并冲突,如果冲突文件符合以下条件:
- 是非二进制文本文件。
- 文件大小小于 200 KB,且已添加冲突标记。
- 使用 UTF-8 兼容编码。
- 不包含冲突标记。
- 在两个分支中的路径相同。
如果文件不符合这些条件,你必须手动解决冲突。
解决冲突的方法
极狐GitLab 在用户界面中显示了可供解决的冲突,您也可以使用以下方法解决冲突:
- 交互模式:适用于只需要选择保留哪一行版本的冲突。
- 内联编辑器:适用于需要手动编辑以合并更改的复杂冲突。
- 命令行:提供对复杂冲突的完全控制。有关更多信息,请参阅 从命令行解决冲突.。
交互模式
交互模式将目标分支合并到源分支,并根据你选择的更改进行合并。
使用交互模式解决合并冲突的步骤:
- 在左侧边栏,选择 搜索或前往 并找到你的项目。
- 选择 代码 > 合并请求 并找到相应的合并请求。
- 选择 概述,然后滚动到合并请求报告部分。
-
找到合并冲突消息,并选择 解决冲突。 GitLab 显示一份包含合并冲突的文件列表。冲突的行会被高亮显示。
- 对于每个冲突,选择 使用我们的版本 或 使用他们的版本 来标记你希望保留的冲突行版本。这个决定被称为 “解决冲突”。
- 当你解决所有冲突后,输入 提交信息。
- 选择 提交到源分支。
内联编辑器
一些合并冲突更加复杂,你需要手动编辑行来解决它们。
合并冲突解决编辑器帮助你在 GitLab 中解决这些冲突:
- 在左侧边栏,选择 搜索或前往 并找到你的项目。
- 选择 代码 > 合并请求 并找到相应的合并请求。
- 选择 概述,然后滚动到合并请求报告部分。
- 找到合并冲突消息,并选择 解决冲突。 GitLab 显示一份包含合并冲突的文件列表。
- 找到需要手动编辑的文件,并滚动到冲突块。
-
在该文件的标题栏中,选择 内联编辑 来打开编辑器。在这个例子中,冲突块从第 1350 行开始,到第 1356 行结束:
- 解决冲突后,输入 提交信息。
- 选择 提交到源分支。
变基
如果你的合并请求卡在 检查自动合并能力
的消息上,你可以:
- 使用极狐GitLab UI 中的
/rebase
快速操作。 - 使用 Git 进行变基。
要排查 CI/CD 管道问题,请参阅 调试 CI/CD 管道。
使用快速操作进行变基
你可以通过 GitLab UI 使用 /rebase
快速操作 来进行变基。
先决条件:
- 不存在合并冲突。
- 你必须至少拥有源项目的 开发者角色。
- 如果合并请求位于一个 Fork 中,则该 Fork 必须允许 来自上游项目成员的提交。
使用快速操作进行变基的步骤:
- 进入你的合并请求。
- 在评论中输入
/rebase
。 - 选择 评论。
极狐GitLab 将调度并执行该分支与默认分支的变基操作。