Git Patch 使用详解：生成、应用与多提交合并导出

在多人协作、代码审查、离线提交或跨仓库迁移的场景中，git patch 是非常实用的技术。本文将系统地介绍如何使用 Git 的补丁机制导出和应用修改内容。

---

📖 什么是 Git Patch？

严格来说，git patch 并不是一个 Git 命令，而是指 使用 Git 的补丁机制，借助以下命令完成相关操作：

• git diff
• git format-patch
• git apply
• git am

这些命令共同构成了 Git 补丁工作流。

---

📦 Git Patch 常用工作流概览

🔹 1. 生成 Patch 文件

✅ 方法 1：仅导出修改内容（不含提交信息）

git diff > my.patch

生成的是基于当前修改与 HEAD 差异的补丁，适合用于分享尚未提交的改动。

---

✅ 方法 2：导出带有提交历史的补丁（推荐）

# 导出某一次提交
git format-patch -1 <commit-hash># 导出最近 3 次提交
git format-patch -3# 导出当前分支与主分支之间的所有提交
git format-patch origin/main..HEAD

这些命令会生成 .patch 文件，每个提交一个文件，名称格式如：

0001-描述.patch
0002-描述.patch

你可以通过 --output-directory=<目录> 指定生成路径：

git format-patch origin/main --output-directory=./patches

---

🔹 2. 应用 Patch 文件

✅ 使用 git apply（不记录提交）

git apply my.patch

• 只会应用内容，不保留原始提交记录。
• 无法撤销，建议先备份或使用 git apply -R 撤销。

---

✅ 使用 git am（保留原始提交信息）

git am 0001-*.patch

或批量导入所有补丁：

git am *.patch

如果出现冲突，可通过：

• git am --abort 中止操作
• git am --skip 跳过冲突补丁
• git am --continue 解决冲突后继续应用

---

🧰 常用命令整理（速查表）

操作	命令示例
导出未提交修改	git diff > my.patch
导出最近 N 次提交	git format-patch -N
导出某个提交	git format-patch -1 <commit-hash>
导出某个分支差异	git format-patch origin/main..HEAD
合并多个 patch 为一个	cat *.patch > all-in-one.patch
应用普通 patch	git apply my.patch
应用带提交记录的 patch	git am *.patch
撤销 apply 应用	git apply -R my.patch
中止 am 应用	git am --abort

---

🎯 进阶：合并多个提交为一个 Patch

如果你有多个已提交的记录想合并为一个 patch，可使用如下方法：

✅ 步骤一：交互式 rebase 合并多个提交

git rebase -i HEAD~3  # 合并最近 3 次提交

将后两个提交改为 squash，保存退出。

---

✅ 步骤二：导出合并后的单一提交

git format-patch -1 HEAD

---

✅ 典型场景：迁移提交到另一个仓库

1. 在源仓库使用 git format-patch 导出提交
2. 在目标仓库使用 git am 应用补丁

# 在源仓库
git format-patch origin/main..HEAD --output-directory=./patch# 在目标仓库
git am ./patch/*.patch

---

📌 注意事项

• 使用 git apply 时不生成提交记录，适合轻量临时修改；
• 使用 git am 会保留作者、提交信息等元数据；
• patch 文件应用失败时，一定记得 git am --abort 清理状态；
• patch 文件内容依赖于当前目录的状态，请保持代码干净。

---

✅ 小结

工具	是否带提交记录	是否可撤销	应用场景
git diff	否	可（-R）	未提交改动的临时导出
git format-patch	是	否	提交历史导出、离线代码迁移
git apply	否	可	应用内容变更，轻量修复
git am	是	是	严谨迁移、有审计需求的场景

---