如何用git命令生成patch和打patch

概述

程序员的日常开发过程中经常会经常做代码托管与提交，对于code的生成patch和打patch成为经常需要做的事情。

什么是patch？

简单地讲，patch中存储的是你对代码的修改

什么是生成patch？

生成patch就是记录你对代码的修改并将其保存在patch文件中

什么是打patch？

打patch就是将patch文件中对代码的修改，应用到源代码，从而把代码的修改应用到code中。

尽管本身Linux命令里有diff和patch两个命令可以生成patch和打patch。但是这两个命令的有两个缺点值得关注下：

1、对同一目录下单个文件或者多个文件，diff和patch这两个命令比较方便。对于git这种以project为单位的修改，尤其是涉及到多个文件夹下的文件的改动是，就很不方便

2、无法保存commit的信息

因此推荐大家使用git的format-patch和am命令进行生成Patch和打patch，用此方法获取的patch其实是commit里提交code修改以及commit信息。有如下好处：

• 能够记录所有的改动可以保存commit信息
• 能够灵活的获取patch，可以获取任意两个commit之间的patch集

git format-patch命令使用

#生成最近的1次commit的patch

$ git format-patch HEAD^ 　　　　　　　　　　　　　   

#生成最近的2次commit的patch

$ git format-patch HEAD^^　　　　　　　　　　　　　  

#生成最近的3次commit的patch

$ git format-patch HEAD^^^ 　　　　　　　　　　　　　

#生成最近的4次commit的patch

$ git format-patch HEAD^^^^ 　　　　　　　　　　　   

#生成两个commit间的修改的patch, r1和r2都是具体的commit号

$ git format-patch <r1>..<r2>                        

#生成r1 commit的patch

$ git format-patch -1 <r1>                           

#生成r1提交以来的修改patch（不包含该commit）

$ git format-patch <r1>                              

#生成从根到r1提交的所有patch

$ git format-patch --root <r1>　　　　　　　　　　　

git apply的命令使用

#查看patch的情况

$ git apply --stat 0001-limit-log-function.patch   　　　　 

#检查patch是否能够打上，如果没有任何输出，则说明无冲突

$ git apply --check  0001-limit-log-function.patch  

上条命令如果出现patch does not apply则表示有冲突，则需要git apply --reject xxx强制打补丁

$ git apply --reject 0001-limit-log-function.patch   

强制打补丁会将没有冲突的补丁自动打上，有冲突就会生成*.rej文件则需要手动打补丁

注：git apply是另外一种打patch的命令，其与git am的区别是，git apply并不会将commit message等打上去，打完patch后需要重新git add和git commit，而git am会直接将patch的所有信息打上去，而且不用重新git add和git commit,author也是patch的author而不是打patch的人)

#将名字为0001-limit-log-function.patch的patch打上

$ git am 0001-limit-log-function.patch                       

#添加-s或者–signoff，还可以把自己的名字添加为signed off by信息，作用是注明打patch的人是谁，因为有时打patch的人并不是patch的作者

$ git am --signoff 0001-limit-log-function.patch        

#将路径~/patch-set/*.patch 按照先后顺序打上

$ git am ~/patch-set/*.patch　　　　　　　　　　　　　       

#当git am失败时，用以将已经在am过程中打上的patch废弃掉(比如有三个patch，打到第三个patch时有冲突，那么这条命令会把打上的前两个patch丢弃掉，返回没有打patch的状态)

$ git am --abort

#当git am失败，解决完冲突后，这条命令会接着打patch

$ git am --resolved

如果打Patch的过程中出现某个文件的patch does not apply发生了冲突（conflicts），怎么办？

解决patch冲突的过程是：

要不停止打这一系列patch了，直接：git am --abort。

如果还想打, 有两种解决方案：

• 方案一：

(1) 根据git am失败的信息，找到发生冲突的具体patch文件，然后用命令git apply --reject <patch_name>，强行打这个patch，发生冲突的部分会保存为.rej文件（例如发生冲突的文件是a.txt，那么运行完这个命令后，发生conflict的部分会保存为a.txt.rej），未发生冲突的部分会成功打上patch

(2) 根据.rej文件，通过编辑该patch文件的方式解决冲突。值得注意的是，.rej文件描述的是现有的源文件与patch文件发生冲突的部分，即因为文件的哪里不一样导致patch打不上去，同时也有patch所没打上的change。

(3) 废弃上一条am命令已经打了的patch：git am --abort

(4) 重新打patch：git am ~/patch-set/*.patch

• 方案二：

(1) 根据git am失败的信息，找到发生冲突的具体patch文件，然后用命令git apply --reject <patch_name>，强行打这个patch，发生冲突的部分会保存为.rej文件（例如发生冲突的文件是a.txt，那么运行完这个命令后，发生conflict的部分会保存为a.txt.rej），未发生冲突的部分会成功打上patch

(2) 根据.rej文件，通过编辑发生冲突的code文件的方式解决冲突。

(3) 将该patch涉及到的所有文件（不仅仅是发生冲突的文件）通过命令git add <file_name>添加到工作区中

(4) 告诉git冲突已经解决，继续打patch: git am --resolved (git am --resolved 和 git am --continue是一样的)

分析：方案一和方案二主要区别是解决冲突的方法不一样。方案一是通过编辑patch文件的方式解决冲突，方案二是通过编辑冲突code文件的方式解决冲突。这两种方案区别比较大：经过实验，核心区别在于，方案一在修改patch时，如果修改的地方比较多,patch可能就打不上了，因为patch文件里对改动的行和列，以及修改了几个字符有精确的描述，很可能你改了想改的代码，却不符合描述了，就无法apply上Patch。方案二无法验证冲突有没有切实的解决。即使你在方案二的第二步乱改一通，也能“打完”发生冲突的patch（并没有检测修改后的code文件跟patch期望的是否相同）。因此，如果采用方案二，那么再解决code文件冲突后，需要人工去确认修改的正确性。

---

作者潘小帅, 是一名Linux底层爱好者，平时写写技术原创文章，徒步，旅游，看电影的爱好，喜欢我的文章可以点赞收藏+关注，感谢你的支持，微信公众号【Linux随笔录】