如何在 Git 中创建和应用补丁

要创建补丁，请针对未提交的更改运行 `git diff > fix.patch`，或者针对上次提交运行 `git format-patch -1 HEAD`。要应用其中一项，请运行 `git apply fix.patch` 或 `git am 0001-my-change.patch`。 当您只想在工作文件夹中进行更改时，请使用 git apply。当您想要原始提交及其消息和作者时，请使用 git am。

什么是 Git 补丁？

补丁是一个文本文件，列出了要在哪些文件中删除和添加哪些行。它适合无法推送到同一远程的情况：通过电子邮件发送修复、在不相关的存储库之间移动更改或将本地更改保留在版本控制之外。当您和其他人共享远程仓库时，分支会更简单。

如何根据未提交的更改创建补丁？

# unstaged changes
git diff > fix.patch

# staged changes
git diff --staged > fix.patch

# everything since the last commit
git diff HEAD > fix.patch

# include binary files
git diff --binary > fix.patch

未暂存的新文件不会出现在 git diff 中。首先对它们运行 git add 并使用 --staged。

如何从提交创建补丁？

# the last commit
git format-patch -1 HEAD

# the last three commits, one file each
git format-patch -3

# everything on this branch that main does not have
git format-patch main..feature/search -o patches/

# all of it in a single file
git format-patch main --stdout > feature.patch

format-patch 写入名为 0001-add-search-box.patch 的文件。每个都保留提交的消息、作者和日期，而普通的 git diff 会丢失这些内容。

如何应用补丁？

先检查一下。这两个命令没有改变：

# what it touches
git apply --stat fix.patch

# whether it will apply
git apply --check fix.patch

然后按照您需要的方式应用它：

# into the working folder, nothing staged
git apply fix.patch

# into the working folder and the staging area
git apply --index fix.patch

# as commits, with their messages and authors
git am patches/*.patch

git apply 和 git am 有什么区别？

如何修复“补丁不适用”？

error: patch failed: src/search.ts:14
error: src/search.ts: patch does not apply

自打补丁以来该文件已更改，因此其上下文行不再匹配。按顺序尝试这些：

1. git apply --3way fix.patch 使用原始 blob 进行合并，并留下正常的冲突标记。它需要您的存储库中的这些 blob。
2. 当只有空格或行结尾不同时，git apply --whitespace=fix fix.patch 会有所帮助。
3. git apply --reject fix.patch 应用其所能，并将失败的部分写入 .rej 文件中，供您手动执行。
4. 检查补丁的提交，将其应用到那里，然后重新设置基准。

对于 git am，使用 git am --3way，解决冲突，git add 文件并运行 git am --continue。要退出，请运行 git am --abort，如如何中止合并或变基 中所列。

如何撤消补丁？

git apply -R fix.patch

-R 反向应用补丁。如果您使用了 git am，则提交是正常提交​​，因此请使用 `git reset` 或 `git revert` 撤消它们。

创建和应用补丁 指南列出了每个选项。