如何使用git 生成patch 和打入patch【轉】

本文轉載自：http://blog.csdn.net/liuhaomatou/article/details/54410361

平時我們在使用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