git format-patch [- | ] [-o ] —— 方括号表示可以省略的部分。

git format-patch

git

用法

git format-patch [-<n>|<since>] [-o <dir>]

为每个提交写出一个邮件格式的 .patch 文件；format-patch main 指的是 main 之后的提交，不含 main 本身。

常用选项

选项	含义
-<n>	the last n commits, e.g. -3
<since>	commits after that one, e.g. origin/main
-o <dir>	write the files into a directory
--stdout	one mbox stream on standard output
--cover-letter	add a 0000 summary mail
-v <n>	mark the series as v<n> of a re-roll
-s	add Signed-off-by

示例

git format-patch -3

writes 0001- to 0003- patch files for the last three commits

git format-patch origin/main --cover-letter -o outbox/

a mailable series of everything not yet upstream

git format-patch -1 --stdout > fix.patch

one commit as a single patch file

难的地方在于撤销有好几种：把分支的指向挪走，和补一个反向提交，不是一回事。

怎么看

Q. git format-patch 是做什么的？

为每个提交写出一个邮件格式的 .patch 文件；format-patch main 指的是 main 之后的提交，不含 main 本身。

Q. 怎么写？

git format-patch [-<n>|<since>] [-o <dir>] —— 方括号表示可以省略的部分。

Q. 值得记的选项有几个？

这里列了 7 个，完整列表在 man git。这条命令属于git。