如何为指定提交生成 Git 补丁文件
为单个提交生成补丁：git format-patch -1 <提交哈希>，生成 0001-说明.patch 文件；对方用 git am < 补丁文件 应用为完整提交（保留作者与提交信息）。只要 diff 用 git show > fix.patch。
用 git format-patch -1 <提交哈希>：生成一个 0001-提交说明.patch 文件，里面不仅有 diff，还包含作者、日期、提交信息——对方用 git am 应用后能还原成一模一样的提交。只要纯 diff 不要元信息时用 git show <哈希> > fix.patch。
常用场景
# 单个指定提交
git format-patch -1 a1b2c3d
# 最近 3 个提交
git format-patch -3
# 某个范围
git format-patch main..feature-x
# 输出到指定目录
git format-patch -1 a1b2c3d -o patches/
应用补丁
git am < 0001-fix-login-bug.patch # 还原为完整提交
git am --3way < fix.patch # 冲突时尝试三方合并
git apply 0001-xxx.patch # 只应用文件改动，不产生提交
format-patch vs show/diff
| 命令 | 产物 | 应用方式 | 保留提交信息 |
|---|---|---|---|
format-patch |
邮件格式补丁 | git am |
✅ 完整还原 |
git show > x.patch |
纯 diff | git apply |
❌ |
git diff |
纯 diff | git apply |
❌ |
跨仓库"搬运提交"用 format-patch；只是分享代码改动用 apply 系列即可。
常见问题（FAQ）
Q：am 应用时冲突怎么办？
git am --3way 会用 blob 信息做三方合并；仍有冲突则进入冲突解决流程，解决后 git am --continue，放弃用 git am --abort。
Q：补丁里带二进制文件怎么办？
format-patch 默认就支持二进制（自动用 binary patch 编码），git apply 需要加 --binary 生成和应用。
Q：能把补丁通过邮件发给维护者吗？
这正是 format-patch 的设计初衷（Linux 内核工作流）：git send-email 可以直接发送。现代团队更多用 PR，但邮件列表社区仍大量使用。
