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 -3writes 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.patchone commit as a single patch file
難的地方在於復原有好幾種：把分支的指向挪走，和補一個反向提交，不是一回事。
怎麼看
- 方括號 [ ] 表示這部分可以不寫。
- 省略號 … 表示可以寫多個。
- 選項區分大小寫——有些命令裡 -r 和 -R 不是一回事。
常見問題
Q. git format-patch 是做什麼的？
為每個提交寫出一個郵件格式的 .patch 檔案；format-patch main 指的是 main 之後的提交，不含 main 本身。
Q. 怎麼寫？
git format-patch [-<n>|<since>] [-o <dir>] —— 方括號表示可以省略的部分。
Q. 值得記的選項有幾個？
這裡列了 7 個，完整列表在 man git。這條命令屬於git。
相關命令
man 手冊: man git-format-patch