Git仓库中合并冲突的解决方法

技术背景

在使用Git进行版本控制时，当多个开发者对同一文件的同一部分进行修改，或者在合并分支时，就可能会出现合并冲突。合并冲突是指Git无法自动决定如何将不同的修改合并到一起，需要开发者手动干预解决。理解和掌握合并冲突的解决方法对于高效的团队协作和项目开发至关重要。

实现步骤

1. 识别冲突文件

当执行合并操作（如git merge、git pull或git rebase）时，如果出现冲突，Git会在终端输出提示信息，告知哪些文件存在冲突。可以使用git status命令查看冲突文件列表，这些文件会显示在“Unmerged paths”部分。

2. 选择解决方式

使用图形化工具

• git mergetool：这是一个强大的命令，它可以打开一个图形化的合并工具，引导你逐步解决每个冲突。不过，该命令不一定会自动打开图形界面，需要安装相应的工具。常见的可配置工具包括meld、opendiff、kdiff3、tkdiff、xxdiff、tortoisemerge、gvimdiff、diffuse、ecmerge、p4merge、araxis、vimdiff、emerge等。
  • 配置示例（以vimdiff为例）：

git config merge.tool vimdiff
git config merge.conflictstyle diff3
git config mergetool.prompt false

- **使用步骤**：配置完成后，执行`git mergetool`，会出现一个`vimdiff`显示界面，包含`LOCAL`（当前分支的文件）、`BASE`（共同祖先的文件）、`REMOTE`（要合并进来的文件）和`MERGED`（合并结果）四个视图。可以使用`ctrl + w`在视图间导航，使用`ctrl + w` followed by `j`直接到达`MERGED`视图。编辑`MERGED`视图时，可使用`:diffg RE`获取`REMOTE`的更改，`:diffg BA`获取`BASE`的更改，`:diffg LO`获取`LOCAL`的更改。完成编辑后，使用`:wqa`保存并退出，然后执行`git commit -m "message"`进行提交，最后使用`git clean`移除额外文件。

手动编辑文件

打开冲突文件，会看到类似以下的冲突标记：

<<<<<<<
Changes made on the branch that is being merged into. In most cases,
this is the branch that I have currently checked out (i.e. HEAD).
|||||||
The common ancestor version.
=======
Changes made on the branch that is being merged in. This is often a 
feature/topic branch.
>>>>>>>

根据实际情况，选择保留上方（当前分支）、下方（要合并的分支）或综合两者的内容，然后删除冲突标记（<<<<<<<、|||||||、=======、>>>>>>>）。编辑完成后，使用git add <文件名>将解决冲突的文件标记为已解决。

选择特定版本

• 接受本地版本：git checkout --ours <文件名>
• 接受远程版本：git checkout --theirs <文件名>

3. 提交合并结果

当所有冲突都解决后，使用git commit命令提交合并结果。如果是在rebase过程中解决冲突，使用git rebase --continue继续rebase操作。

核心代码

使用vimdiff解决冲突的配置和操作代码

# 配置vimdiff为默认合并工具
git config merge.tool vimdiff
git config merge.conflictstyle diff3
git config mergetool.prompt false

# 启动合并工具
git mergetool

# 保存并退出vimdiff
:wqa

# 提交合并结果
git commit -m "message"

# 移除额外文件
git clean

选择特定版本的代码

# 接受本地版本
git checkout --ours <文件名>

# 接受远程版本
git checkout --theirs <文件名>

# 添加解决冲突的文件
git add <文件名>

# 提交合并结果
git commit -m "merged bla bla"

最佳实践

提前规划和沟通

在进行开发前，与团队成员沟通好各自的工作范围和计划，避免对同一文件的同一部分进行修改。对于大型重构或涉及多个文件的修改，考虑串行工作，减少冲突的发生。

定期合并下游

定期将主分支的更改合并到自己的开发分支，保持分支的更新，减少冲突的复杂度。可以使用git pull --rebase命令，它会自动同步最新的远程服务器更改，并将本地最新提交放在Git日志的顶部。

使用diff3合并冲突风格

通过git config merge.conflictstyle diff3配置，在冲突标记中显示共同祖先的版本，有助于更好地理解每个分支的更改，从而更准确地解决冲突。

自动化验证

在解决冲突后，运行自动化测试、代码检查工具或进行项目构建，确保更改没有引入新的问题。

常见问题

--ours和--theirs的含义混淆

在合并和变基操作中，--ours和--theirs的含义是不同的。在合并时，--ours表示要合并到的分支，--theirs表示要合并进来的分支；在变基时，含义相反。

git add和git commit的使用问题

在解决冲突后，需要使用git add将解决冲突的文件添加到暂存区，然后再使用git commit进行提交。如果在合并过程中只进行git add而不进行git commit，可能会导致合并不完整。

图形化工具未正确打开

运行git mergetool时，可能不会自动打开图形界面，需要安装相应的工具并进行配置。例如，在使用kdiff3时，需要进行如下配置：

git config --global --add merge.tool kdiff3
git config --global --add mergetool.kdiff3.path "C:/Program Files/KDiff3/kdiff3.exe"
git config --global --add mergetool.kdiff3.trustExitCode false

git config --global --add diff.guitool kdiff3
git config --global --add difftool.kdiff3.path "C:/Program Files/KDiff3/kdiff3.exe"
git config --global --add difftool.kdiff3.trustExitCode false

并确保路径是实际的KDiff3可执行文件路径。