详解Git合并冲突——问题重现、原因及解决 “Automatic merge failed； fix conflicts and then commit the result.“

开源 0

最后更新日期：2022/10/6

在Git中使用git merge命令合并两个分支的时候，有可能产生这种情况：

$ git merge AAuto-merging merge.txtCONFLICT (content): Merge conflict in merge.txtAutomatic merge failed; fix conflicts and then commit the result.

这就是发生了冲突（conflict）。

为什么会有冲突？要如何解决呢？请看下文介绍。

目录

  • 为什么会发生冲突？
  • 制造一个冲突
    • 第一步：初始化仓库及文件
    • 第二步：在新分支上更改并提交文件
    • 第三步：在主分支上更改并提交文件
    • 第四步：执行合并，触发冲突
  • 如何查看冲突？
  • 如何解决冲突？
  • 总结
  • 其他问题

为什么会发生冲突？

简单来说，就是两个分支都对同一个文件做了更改，当这两个分支合并的时候，Git不知道要采用哪一个更改，便发生了冲突。

图1 一个冲突的例子

举个栗子，假设刚开始master分支版本为C0，然后依次发生了以下情况：

  1. 小A基于C0创建新分支new_branch，并在该分支上改动了文件merge.txt，提交得到版本C2
  2. 小B在主分支master上进行开发，同样改动了merge.txt，提交得到版本C1

此时，如果用git merge将master与new_branch合并，就会发生冲突。完整的过程如图1所示。

Git提示冲突，也是一件好事，它其实是在告诉你：
“你让我合并new_branch和master两个分支，但是它们两个都改动了merge.txt，一个说要这样改，一个说要那样改，我应该听谁的呀？你来帮我看下吧！”。（形象解释）

在讲解如何解决冲突之前，我们得先有一个冲突。下面将根据图1制造出一个冲突。

制造一个冲突

制造图1的冲突分为4个步骤：

  • 第一步：初始化仓库及文件
  • 第二步：在新分支上更改并提交文件
  • 第三步：在主分支上更改并提交文件
  • 第四步：执行合并，触发冲突

第一步：初始化仓库及文件

首先创建一个新仓库。打开Git Bash，顺序执行以下命令：

$ mkdir git-merge-test$ cd git-merge-test$ git initInitialized empty Git repository in path/to/your/work/dictionary/git-merge-test/.git/

以上命令在当前位置创建了一个名为git-merge-test的文件夹，并将其初始化为Git仓库。

然后创建仓库文件。在仓库根目录下新建merge.txt，写入以下内容：

这是第一行，这行不会被修改这是第二行

在这里插入图片描述

添加merge.txt到暂存区并提交更改：

$ git add .$ git commit -m"初始化仓库内容"[master 8bc6262] 初始化仓库 Date: Wed Oct 5 16:30:35 2022 +0800 1 file changed, 2 insertions(+) create mode 100644 merge.txt

此时，master处于图1中的C0。

第二步：在新分支上更改并提交文件

然后，创建一个新分支new_branch:：

$ git checkout -b new_branchSwitched to a new branch 'new_branch'

说明：git checkout -b 分支名表示创建一个新分支并切换到这个分支上。

修改merge.txt：

这是第一行，这行不会被修改我在new_branch分支上修改了第二行

在这里插入图片描述

添加merge.txt并提交更改：

$ git commit -am"修改merge.txt"[new_branch 8eb88a9] 修改merge.txt 1 file changed, 1 insertion(+), 1 deletion(-)

说明：git commit -am"提交信息"中的选项a表示先git add所有发生改动的文件再提交。

此时，new_branch位于图1中的C2。

第三步：在主分支上更改并提交文件

$ git checkout masterSwitched to branch 'master'$ echo "我在master分支上添加了第三行" >> merge.txt$ git commit -am"新增内容到merge.txt"[master 52c86fa] 新增内容到merge.txt 1 file changed, 1 insertion(+)

上述命令的意思是，先切换回master分支，然后往merge.txt中添加一行内容（">>"表示追加重定向文件），最后提交更改。

此时，master位于图1中的C1。

第四步：执行合并，触发冲突

在合并之前，我们先捋一下现在的状况：

  • 最初的merge.txt的内容为：
    这是第一行，这行不会被修改这是第二行
  • 在new_branch分支上改动后的merge.txt内容为：
    这是第一行，这行不会被修改我在new_branch分支上修改了第二行
  • 在master主分支上改动后的merge.txt内容为：
    这是第一行，这行不会被修改这是第二行我在master分支上添加了第三行

两个分支都改动了merge.txt，合并会发生什么呢？下面就来试一下。

在master分支上执行git merge new_branch，尝试把new_branch分支合并过来：

$ git merge new_branchAuto-merging merge.txtCONFLICT (content): Merge conflict in merge.txtAutomatic merge failed; fix conflicts and then commit the result.

可以看到，冲突发生了。

在解决冲突之前，应该先要知道如何查看冲突。下面将进行介绍。

如何查看冲突？

文章刚开始已经提到，合并时发生冲突，是因为两个分支都对同一个文件做了更改。当合并master和new_branch的时候，Git发现对于merge.txt，一个分支这样改，另一个分支那样改，就陷入了两难。从报错信息可知，冲突需要我们手动解决后方可提交。

很多人到这里就懵了，不知道该怎么弄。实际上，我们现在正处于合并的“中间状态”。合并的中间状态就是合并了，但还没完全合并。。好吧，是废话，意思就是你执行git merge了，但git merge并没有执行完成（因为发生冲突了），需要你解决冲突后继续进行。

敲入git status，就可以看到这样的信息：

$ git statusOn branch masterYou have unmerged paths.  (fix conflicts and run "git commit")  (use "git merge --abort" to abort the merge)Unmerged paths:  (use "git add <file>..." to mark resolution)        both modified:   merge.txtno changes added to commit (use "git add" and/or "git commit -a")

git status告诉我们以下信息：

  • “You have unmerged paths”：我们现在正处于合并的中间状态，有一些没有合并的文件；
  • “Unmerged paths”：下面列出了所有未合并的文件，都显示为红色（网页上看不到）。可以看到，merge.txt没有合并，因为两个分支都更改了它（“both modified”），发生了冲突。我们要先把冲突解决了。

那我们现在就来查看冲突。用编辑器打开merge.txt，会发现内容变成了这样：

这是第一行，这行不会被修改<<<<<<< HEAD这是第二行我在master分支上添加了第三行=======我在new_branch分支上修改了第二行>>>>>>> new_branch

里面多了三行我们看不懂的记号：

  • <<<<<<< HEAD
  • =======
  • >>>>>>> new_branch

这些记号是标记冲突内容的分隔线，解释如下：

  • <<<<<<< HEAD和=======之间的内容：是master分支修改的内容（准确来说是HEAD指针指向的分支修改的内容）；
  • =======和>>>>>>> new_branch之间的内容：是new_branch分支修改的内容；
  • 分割线之外的内容：是两个分支都没有改动的内容（如merge.txt第一行）。

看懂了吗？然后，解决冲突就变得很简单了。

如何解决冲突？

解决冲突只需3步：

  1. 编辑冲突文件。决定要保留的内容，然后删掉三行分割线
  2. git add将冲突文件添加到暂存区
  3. git commit提交

对于第1步，要按照你的具体情况去改。通常情况下，我们有这两种做法：

  • 保留其中一个修改，删掉另一个
  • 同时保留两个修改

不管怎样，最终改好的文件会原封不动地提交到仓库中。另外需要注意，最后不要忘了删掉三行分隔线，即：<<<<<<< HEAD，=======，>>>>>>> new_branch

在我们的例子中，假如我们想同时保留两个分支的修改，那么可以编辑merge.txt，仅删掉三行分隔线，其他部分不用管，得到以下内容：

这是第一行，这行不会被修改这是第二行我在master分支上添加了第三行我在new_branch分支上修改了第二行

改好后，就可以提交了：

$ git add merge.txt$ git commit -m "合并new_branch分支并解决冲突"[master 0c88c4f] 合并new_branch分支并解决冲突

查看合并后的提交记录：

$ git logcommit 0c88c4f9210af067125c9027f3e5885065f88dd0 (HEAD -> master)Merge: 52c86fa 8eb88a9Author: lanjianghao <528601933@qq.com>Date:   Wed Oct 5 22:28:34 2022 +0800    合并new_branch分支并解决冲突commit 52c86fa51bca34c7763ed7b56b7705b3ce31379cAuthor: lanjianghao <528601933@qq.com>Date:   Wed Oct 5 19:23:32 2022 +0800    新增内容到merge.txtcommit 8eb88a9d1dc88b30333492ec44c12685aaa8187c (new_branch)Author: lanjianghao <528601933@qq.com>Date:   Wed Oct 5 19:17:06 2022 +0800    修改merge.txtcommit 8bc626277eec39e413dcdd764642865b5291674eAuthor: lanjianghao <528601933@qq.com>Date:   Wed Oct 5 16:30:35 2022 +0800    初始化仓库

可以看到，日志中新增了一条合并记录。

总结

  • 为什么合并时发生了冲突？
    • 要合并的两个分支改动了同一个文件，Git不知道要采用哪个，还是两个都采用，需要由你来决定。
  • 怎样查看冲突？
    • git status查看冲突的文件
    • 编辑器打开冲突的文件，查看冲突的内容
    • 冲突内容分隔线怎么看：
      未冲突的内容（两个分支都未改动）在分隔线外面<<<<<<< HEADGit当前所在分支修改的内容（准确来说是HEAD指针指向的分支修改的内容）=======要合并过来的分支修改的内容>>>>>>> branch_to_merge
  • 怎样解决冲突？
    1. git status查看冲突的文件
    2. 编辑冲突文件，解决冲突（记得删除三行分隔线）
    3. git add 冲突文件
    4. git commit -m "提交信息"

其他问题

  • 我不想继续合并了，如何退出合并的中间状态？
    git merge --abort
    前文中提到，如果执行git merge合并时发生冲突，则会进入合并的中间状态。合并的中间状态下将无法执行其他一些操作（如切换分支）。
    如果不想继续合并，要先用git merge --abort命令退出。该命令会使你回到执行git merge 分支之前的状态。

感谢大家能看到这里！本人也还是小白，如果有不对的地方，欢迎指正！

参考：
https://www.atlassian.com/git/tutorials/using-branches/merge-conflicts

也许您对下面的内容还感兴趣：