libgit2使用教程（七）git merge

这篇的主要内容是合并操作，是 git 中非常重要的操作。合并就有可能出现冲突，所以同时会简单介绍一下解决冲突。
合并操作主要针对的对象实际上并不是分支，只不过 commit 组成了一条分支，所以可以用分支来作为 commit 的索引。我们首先需要找到需要合并过来的那个 commit （或者多个 commit）。示例只简单的将一个分支最新的 commit 合并到 HEAD ，更多拓展的操作您可以自己发挥。
首先获得分支最新的 commit ：

DWIM 的意思貌似是：Do What I Mean

然后调接口实现 merge ：

上面这几行代码就实现了 merge 操作，然而，不要以为就这样就结束了，调用完 merge 接口才是刚刚开始。这个时候合并操作会被更新到 index，但是并不会写到 tree 里 ，所以后边的 add 和 commit 操作还是需要写的。到目前为止这个操作可能叫 try merge 更合理一些。
需要补充一点，如果 merge 没有成功，有可能存在有没处理完的合并，因为有可能在之前的合并操并没有走完全部流程就被强制终止了。这个时候 git_merge 是会报错的，所以如果报错了需要做一下判断，是继续上次未完成的合并，或是做一下清理：

这个状态清理，是合并操作流程完成后一定要调用的，否则磁盘上的标志文件会一直存在，会影响下一次合并操作。

git_merge 操作完成后，就要检查一下是否有冲突：

需要通过 index 来检查。
如果是有冲突的情况，可以通过 conflict_iterator 对冲突进行遍历：

解决冲突有几种方式：
1. 直接 checkout –ours(theirs) 快速选择一个版本作为最终合并后的版本：

也可以选择对指定文件 checkout ，只要设置一下 options 的参数：

2. 手动改写工作目录下的文件，通过取出的 git_index_entry 的 oid 可以获得对应版本文件的 blob ，这样可以把对应文件的内容取出。根据需要，将工作目录下的文件改写，这个就完全看自己的业务逻辑需要了，所以就不提供参考代码了。
之后要将这个解决完的冲突 remove 掉：

 

现在解决完冲突的文件状态已经在硬盘上体现出来了，但是实际上并没有完全更新到 index ，接下来就依照文件更新后 add 和 commit 的操作：更新 index→生成 tree → commit 来完成整个合并操作。
需要注意的一点是，因为是两个 commit 合并成新的 commit 所以这个新的 commit 的 parent 应该有两个：

这些细节在之前写过了，所以就不细说了。最后将合并状态清理一下就可以结束了：

补充说明
虽然 git_merge 传入了 annotated_commit 的数组，但是从实现代码上来看，合并操作只取了数组的第0个元素，所以实际上并不能实现同时将好多个 commit 合并的 HEAD。