如何使用git 生成patch 和打入patch

平時我們在使用git 管理專案的時候，會遇到這樣一種情況，那就是客戶使用git 生成patch 給到我們，那我們就需要把客戶給到patch 打入到我們的project ，基於這樣一個場景，我把git 如何生成patch 和如何打入patch 做總結

生成patch 的方法：(我這裡描述的生成patch 是根據commit 記錄生成的)

1.例如首先先通過git log 檢視有哪一些commit

2.把第一次commit 提交以後的（不包括第一次提交）都生成patch 

如上圖所示：使用命令：git format-patche795fefabc

然後生成的patch 檔案如下圖所示

打入patch 的方法：

把生成的patch 檔案copy 到一個資料夾中來（這裡我建立了patch 資料夾）。如下圖所示

由於這些patch顯然是用git format-patch來生成的，所以用git的工具應該就可以很好的做好。git am 就是作這件事情。

在使用git am之前， 你要首先git am --abort 一次，來放棄掉以前的am資訊，這樣才可以進行一次全新的am。
不然會遇到這樣的錯誤。
                .git/rebase-apply still exists but mbox given.

git am 可以一次合併一個檔案，或者一個目錄下所有的patch，如下圖所示：

 

1 使用git format-patch生成所需要的patch:
當前分支所有超前master的提交：
git format-patch -M master
某次提交以後的所有patch:
git format-patch 4e16 --4e16指的是commit名
從根到指定提交的所有patch:
git format-patch --root 4e16
某兩次提交之間的所有patch:
git format-patch 365a..4e16 --365a和4e16分別對應兩次提交的名稱
某次提交（含）之前的幾次提交：
git format-patch –n 07fe --n指patch數，07fe對應提交的名稱
故，單次提交即為：
git format-patch -1 07fe
git format-patch生成的補丁檔案預設從1開始順序編號，並使用對應提交資訊中的第一行作為檔名。如果使用了-- numbered-files選項，則檔名只有編號，不包含提交資訊；如果指定了--stdout選項，可指定輸出位置，如當所有patch輸出到一個檔案；可指定-o <dir>指定patch的存放目錄；


2應用patch：
先檢查patch檔案：git apply --stat newpatch.patch
檢查能否應用成功：git apply --check newpatch.patch
打補丁：git am --signoff < newpatch.patch

(使用-s或--signoff選項，可以commit資訊中加入Signed-off-by資訊)

 

如果應用patch出現問題：

比如，一個典型的git am失敗，可能是這樣的：

$ git am PATCH

Applying: PACTH DESCRIPTION

error: patch failed: file.c:137

error: file.c: patch does not apply

error: patch failed: Makefile:24

error: libavfilter/Makefile: patch does not apply

Patch failed at 0001 PATCH DESCRIPTION

When you have resolved this problem run "git am --resolved".

If you would prefer to skip this patch, instead run "git am --skip".

To restore the original branch and stop patching run "git am --abort".

 

正如你所見，如果衝突發生，git只是輸出上述資訊，然後就停下來。一個小衝突會導致整個patch都不會被整合。

 

處理這種問題的最簡單方法是先使用 git am --abort，然後手動的新增此patch, patch -p1 < PATCH，手動解決掉程式碼衝突，最後使用 git commit -a 提交程式碼。但是這樣做有個問題就是你會失去PATCH中原本包含的commit資訊（比如From，Date，Subject，Signed-off-by等）。應該有一種更聰明的方法。

 

在 .git/rebase-apply 目錄下，存放著相應的補丁檔案，名字是“0001” （在更新的git版本中，存放補丁檔案的目錄名有所改變，這裡使用的git版本是 1.7.4.1）。

 

事實上，你可以使用 git apply 命令打patch（git apply 是git中的patch命令）。如同使用 patch -p1 命令時一樣，然後手動解決程式碼衝突（檢視生成的 .rej 檔案，與衝突檔案比較，修改衝突內容，並最終把檔案加入到index中）：

 

$ git apply PATCH --reject

$ edit edit edit

（譯註：根據.rej檔案手動解決所有衝突）

$ git add FIXED_FILES

$ git am --resolved

就這麼簡單！

想多一些解釋，好吧。git am 並不改變index，你需要使用 git apply --reject 打patch（儲存在 .git/rebase-apply），手動解決程式碼衝突，（譯註：使用 git status 列出所有涉及檔案），把所有檔案（不僅僅是引起衝突的檔案）新增到（git add）index，最後告訴 git am 你已經解決（--resolved）了問題。這樣做的好處是你不需要重新編輯commit資訊。而且，如果你正在打的是一系列patch（就是說你在打的是多個patch，比如 git am *.patch）你不需要使用 git am --abort，然後又 git am。

 

參考資料：

Git-format-patch(1) - Linux man page http://linux.die.net/man/1/git-format-patch

How to create and apply a patch with Git http://ariejan.net/2009/10/26/how-to-create-and-apply-a-patch-with-git