首页/开发/Git 与协作速查/git format-patch 生成补丁文件
协作与代码评审75 条

git format-patch 生成补丁文件

把提交导出为邮件格式补丁(含作者、提交信息与差异),用于无平台协作的评审、跨网络传递或离线归档。

Git 与协作速查开发更新于 2026-10-12
用途生成 .patch 文件序列
语法git format-patch -o <目录> <范围>
配套git am 应用;--cover-letter 生成说明信;-M -C 保留重命名信息

常用示例

常用示例
git format-patch -o /tmp/patches -1 HEAD
git format-patch --cover-letter -o /tmp/patches origin/main..feature/login
git format-patch -M -C -o out/ v1.2..v1.3
生成的补丁可用 git am 完整还原作者与提交信息,适合上游不接受直接推送的项目。

易错点

  • 打开邮箱自动换行或重编码会破坏补丁,传递时使用附件或原样文本
  • 二进制改动默认会以二进制补丁随邮件输出(体积膨胀、易被邮件链路损坏),更稳妥的做法是改用 bundle 或平台协作

数据来源与参考

  • Git 官方文档:git-format-patch
  • Pro Git 2nd Edition · 5.3 维护项目
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌