Git 小教室「在 Merge 之前想試試看有沒有衝突？」

當你開了一個新的 branch，然後做了幾個 commit，進度做得差不多之後，下一步就是準備使用 git merge 指令來進行合併。但你手邊的專案可能有好一陣子沒跟線上的同步，這個 merge 執行下去可能噴一堆的衝突要解決。

不久前在社群分享就有朋友問到，有沒有辦法可以在進行 merge 之前先看看會不會發生衝突發生？

除了直接合併下去，衝突再解掉或是再 git reset 回來就好的方法之外， git merge 指令目前並沒有類似 git commit --dry-run 的乾跑參數。

假設想要合併分支 cat，想做到乾跑效果可以這樣做：

$ git merge cat --no-commit --no-ff

根據 Git 的說明手冊，對於 --no-commit 參數的說明如下：

With --no-commit perform the merge but pretend the merge failed and do not autocommit, to give the user a chance to inspect and further tweak the merge result before committing.

這個參數會假裝這次的合併失敗，並且不會產生新的 commit，讓使用者有機會可以在 commit 前再做一些事。

而後面再加上 --no-ff 參數則是不希望 Git 使用 Fast Forward 方式合併，如果想了解 Fast Forward 是怎麼回事，歡迎參閱「為什麼我的分支都沒有『小耳朵』」章節。

那，就讓我們實際來操作一次：

目前專案裡有 master 跟 cat 兩個分支，cat 分支是從 master 分出去的，狀態如下：

$ git merge cat --no-commit --no-ff
Automatic merge went well; stopped before committing as requested

Good! 沒發生衝突，但也沒產生 Commit 或 Fast Forward。看一下目前的 Git 狀態：

$ git status
On branch master
All conflicts fixed but you are still merging.
  (use "git commit" to conclude merge)

Changes to be committed:

  new file:   cat1.html
  new file:   cat2.html

的確就停在 Commit 之前的狀態，cat1.html 跟 cat2.html 都被放到暫存區了。

要注意的是，這個地方如果沒有加上 --no-ff 的話，雖然不會產生 Commit，但還是因為 Fast forward 而完成合併。

剛剛這個例子太順利的，沒有每天在過年的，讓我們再來看一個會衝突的例子：

在這個例子裡，payment 分支跟 member 因為剛好改到同一個檔案，所以 merge 應該會發生衝突：

$ git merge member --no-commit --no-ff
Auto-merging index.html
CONFLICT (content): Merge conflict in index.html
Automatic merge failed; fix conflicts and then commit the result.

果然發生衝突了。看一下狀態：

$ git status
On branch payment
You have unmerged paths.
  (fix conflicts and run "git commit")
  (use "git merge --abort" to abort the merge)

Changes to be committed:

  new file:   member.html

Unmerged paths:
  (use "git add <file>..." to mark resolution)

  both modified:   index.html

回到過去

在上面這兩個範例中，git reset --merge 指令來回到合併之前的狀態，而在 Git 1.7.4 版本之後，可使用 git merge --abort 也可以跟上面這個指令一樣的效果：

$ git merge --abort

再看一下狀態：

$ git status
On branch payment
nothing to commit, working tree clean

這樣就回到合併之前的狀態了。

來看一下這個 --abort 參數的手冊說明：

The second syntax ("git merge --abort") can only be run after the merge has resulted in conflicts. git merge --abort will abort the merge process and try to reconstruct the pre-merge state.

簡單的說，如果合併沒有順利完成的話，這個參數可以讓專案會回到合併之前的狀態。

歡迎來聊聊

有任何跟 Git 有關的疑難雜症或是應用情境，都歡迎來信或留言，如果討論的篇幅夠多就會另外整理一篇文章供大家參考。