Git 补丁— diff 和 patch 使用详解
1. diff 和 patch 的区别
Git 提供了两种补丁方案,一种是通过 git diff 生成的 .diff 文件,第二种是通过 git format-patch 生成的 .patch 文件。
通过 git diff 生成的文件不含有 commit 信息,可以指定文件生成 diff,也可以指定单个 commit, 多个 commit 生成 。通过 git format-patch 生成的 .patch 文件 含有 commmit 信息。一个 commit 对应一个 patch 文件。
在实际开发中,我们会经常用到补丁,不论是在代码迁移,还是bug修复中,都时常使用。
2. 生成patch
2.1 git diff
指定文件生成 patch 文件
patch 补丁即为根据 git diff 生成的文本内容文件,最简单的生成方法为 git diff > test.patch。
举例子:比如我们修改了 A.java、B.java 文件,我们只想将 A.java 文件的修改打成 patch,那么我们可以使用以下的命令: ??git diff A.java > test.patch
想把所有的修改文件打成 patch,即 A.java、B.java 文件,只需要使用下面的命令: ??git diff > test.patch
指定 commit id 生成 patch
使用命令行 ??git diff 【commit sha1 id】 【commit sha1 id】 > 【diff文件名】
3. git format-patch
当前分支所有超前master的提交: ??git format-patch -M master
某次提交以后的所有 patch: ??git format-patch [commit id]
[commit id] 指的是 commit 名,可以通过 git log 查看。
从根到指定提交的所有patch: ??git format-patch --root 4e16
某两次提交之间的所有patch: ??git format-patch 【commit sha1 id】..【commit sha1 id】
举例:
git format-patch 365a..4e16
–365a和4e16分别对应两次提交的名称
某次提交(含)之前的几次提交: ??git format-patch –n 【commit id】
举例:
git format-patch –n 07fe
–n 指 patc h数,07fe 对应提交的名称
故,单次提交即为:
??git format-patch -1 【commit id】
git format-patch 生成的补丁文件默认从1开始顺序编号,并使用对应提交信息中的第一行作为文件名。如果使用了-- numbered-files 选项,则文件名只有编号,不包含提交信息;如果指定了–stdout选项,可指定输出位置,如当所有patch输出到一个文件;可指定 -o 指定 patch 的存放目录;
3. 应用patch
先检查patch文件: ??git apply --stat xxx.patch
检查能否应用成功 ??git apply --check xxx.patch
打补丁: ??git apply xxx.patch
如果应用 patch 出现问题:
比如,一个典型的git apply失败,可能是这样的: 正如你所见,如果冲突发生,git只是输出上述信息,然后就停下来。一个小冲突会导致整个patch都不会被集成。
4. 冲突解决
当我们打补丁出现冲突的时候,这个时候需要我们手动解决冲突。
首先,执行以下命令,自动合入 patch 中不冲突的代码,同时保留冲突的部分 ??git apply --reject xxxx.patch
同时会生成后缀为 .rej 的文件,保存没有合并进去的部分的内容,可以参考这个进行冲突解决。
题外话
在实际开发当中,我们 apply patch 的时候,通常会使用 git 图形工具,因为一旦产生冲突,解决比较方便,比较常用的 git 工具有 sourceTree, TortoiseGit(小乌龟)。
|