Git Squash教程：轻松合并最近N次提交
Git Squash 教程：轻松合并最近 N 次提交
在软件开发过程中，使用 Git 进行版本控制是至关重要的。Git 提供了强大的分支管理和协作功能，但在频繁提交代码的过程中，我们可能会产生大量细碎的提交记录。这些细碎的提交记录可能会让 commit 历史变得杂乱，不利于代码审查和问题追踪。
Git Squash（压缩）就是解决这一问题的利器。Squash 操作可以将多个连续的提交合并成一个单一的、更具意义的提交，从而保持 commit 历史的整洁和可读性。本文将详细介绍 Git Squash 的概念、使用场景、操作方法以及注意事项，帮助您轻松掌握这项实用的 Git 技巧。
一、什么是 Git Squash？
Git Squash 的字面意思是“压扁”、“挤压”，在 Git 中，它指的是将多个连续的提交合并成一个提交的操作。想象一下，您连续修改了一个文件，每次修改都进行了一次提交，产生了 A、B、C 三个提交。使用 Squash 操作，您可以将这三个提交合并成一个提交 D，D 包含了 A、B、C 三次提交的所有更改。
Squash 操作通常通过 git rebase -i（交互式变基）命令来实现。在交互式变基过程中，您可以选择将哪些提交进行 squash，并修改最终合并提交的 commit message。
二、为什么要使用 Git Squash？
使用 Git Squash 主要有以下几个好处：
- 保持 commit 历史的整洁: 将多个细碎的提交合并成一个有意义的提交，可以减少 commit 数量，使 commit 历史更加清晰、易于浏览。
- 方便代码审查: 审查者可以一次性审查多个相关的更改，而无需在多个提交之间来回切换，提高审查效率。
- 简化问题追踪: 当出现 bug 时，可以通过二分查找法（
git bisect）更快地定位到引入问题的提交，因为 commit 数量减少了。 - 更符合语义化的提交: 将多个相关的更改合并成一个提交，可以更好地表达这次提交的意图，使 commit message 更具语义化。
- 便于协作: 在团队协作中，干净的 commit 历史可以减少冲突，提高协作效率。
三、Git Squash 的使用场景
以下是一些常见的适合使用 Git Squash 的场景：
- 开发过程中的细碎提交: 在开发新功能或修复 bug 的过程中，您可能会进行多次小的提交，例如修复拼写错误、调整代码格式、添加调试信息等。这些提交没有必要单独保留，可以使用 Squash 合并。
- 合并 feature 分支: 当您完成一个 feature 分支的开发，准备将其合并到主分支（如
main或develop）时，可以使用 Squash 将 feature 分支上的多个提交合并成一个提交，以保持主分支的 commit 历史简洁。 - 修复之前的提交: 如果您发现之前的提交存在问题，需要进行修复，可以创建一个新的提交来修复问题，然后使用 Squash 将修复提交与原提交合并。
- 撤销之前的提交: 如果您需要撤销之前的某个提交，可以创建一个新的提交来撤销更改，然后使用 Squash 将新提交与原提交合并（效果类似于
git revert，但不会产生新的 revert commit）。
四、Git Squash 的操作方法（以合并最近 N 次提交为例）
下面将详细介绍如何使用 git rebase -i 命令来合并最近 N 次提交。
步骤 1：确定要合并的提交数量 N
首先，您需要确定要合并最近的几次提交。您可以使用 git log 命令查看 commit 历史，确定要合并的提交范围。
bash
git log --oneline # 使用简洁的格式查看 commit 历史
假设我们要合并最近的3次提交。
步骤 2：启动交互式变基
使用 git rebase -i 命令启动交互式变基。-i 选项表示交互式（interactive）。您需要指定一个基准提交，通常是您要合并的提交范围之前的那个提交。
有几种方式可以指定这个基准提交：
- 使用 commit hash: 您可以使用
git log查看到的 commit hash。 - 使用相对引用: 例如，
HEAD~3表示当前提交（HEAD）之前的第 3 个提交。
假设我们要合并最近3次提交，我们可以使用：
bash
git rebase -i HEAD~3
或：
获取最近3次提交之前的commit id, 假设是a1b2c3d4
bash
git rebase -i a1b2c3d4
步骤 3：编辑提交列表
执行上述命令后，Git 会打开一个文本编辑器（通常是 Vim 或 Nano），显示您选择的提交范围内的提交列表。每一行代表一个提交，最旧的提交在最上面，最新的提交在最下面。每行开头的单词是 Git 命令，默认是 pick，表示保留该提交。
```
pick f7f3f6d commit message 1
pick 310154e commit message 2
pick a5f4a0d commit message 3
Rebase 7dd81e8..a5f4a0d onto 7dd81e8 (3 commands)
Commands:
p, pick = use commit
r, reword = use commit, but edit the commit message
e, edit = use commit, but stop for amending
s, squash = use commit, but meld into previous commit
f, fixup = like "squash", but discard this commit's log message
x, exec = run command (the rest of the line) using shell
b, break = stop here (continue rebase later with 'git rebase --continue')
d, drop = remove commit
l, label
t, reset
m, merge [-C | -c ]
. create a merge commit using the original merge commit's
. message (or the oneline, if no original merge commit was
. specified). Use -c to reword the commit message.
These lines can be re-ordered; they are executed from top to bottom.
If you remove a line here THAT COMMIT WILL BE LOST.
However, if you remove everything, the rebase will be aborted.
Note that empty commits are commented out
```
步骤 4：选择 Squash 操作
要将提交合并到前一个提交，您需要将 pick 命令更改为 squash 或 s。squash 命令会将当前提交合并到前一个提交，并保留当前提交的 commit message。
如果您希望合并提交并丢弃当前提交的 commit message，可以使用 fixup 或 f 命令。
例如，要将后两个提交合并到第一个提交，您可以将提交列表修改为：
pick f7f3f6d commit message 1
squash 310154e commit message 2
squash a5f4a0d commit message 3
步骤 5：保存并退出编辑器
修改完成后，保存并退出编辑器。Git 会根据您的修改执行变基操作。
步骤 6：编辑最终的 commit message
如果使用了 squash 命令，Git 会再次打开一个文本编辑器，让您编辑最终合并提交的 commit message。编辑器中会包含所有被 squash 的提交的 commit message。您可以根据需要修改这些 message，整合成一个更具描述性的 message。
编辑完成后，保存并退出编辑器。Git 会完成变基操作，并将多个提交合并成一个提交。
步骤 7：推送更改（如果需要）
如果您是在本地分支上进行操作，并且还没有将更改推送到远程仓库，那么您不需要执行任何额外的操作。
但是，如果您已经将更改推送到远程仓库，或者您正在共享分支上进行操作，那么您需要使用强制推送（git push --force 或 git push --force-with-lease）来更新远程仓库。
警告： 强制推送会覆盖远程仓库上的提交历史，请谨慎使用。如果其他人在同一分支上工作，强制推送可能会导致他们的工作丢失。在强制推送之前，请务必与团队成员沟通。
推荐使用git push --force-with-lease, 它会在你本地分支和远程分支不一致时，拒绝push, 避免你意外覆盖了别人的提交。
五、其他 Squash 操作方式
除了使用 git rebase -i HEAD~N，还有其他一些方式可以实现 Squash：
-
指定 commit hash 范围:
您可以直接指定要合并的提交的 hash 范围：
bash
git rebase -i <start_commit_hash> <end_commit_hash>
将<start_commit_hash>替换成区间内最旧一次提交之前的提交id
<end_commit_hash>替换成区间内最新一次提交的id -
合并到指定提交:
如果您想将多个提交合并到某个特定的提交，可以使用：
bash
git rebase -i <target_commit_hash>
将<target_commit_hash>替换成要合并到的那次提交的id。
然后将要合并的那几次提交的pick 改成 squash.
六、注意事项
- 不要 Squash 已经推送到远程仓库的公共分支的提交: Squash 操作会改变 commit 历史，如果您 Squash 了已经推送到远程仓库的公共分支（如
main、develop）的提交，会导致其他人的本地仓库与远程仓库不一致，给协作带来麻烦。 - 在 feature 分支上进行 Squash: 通常情况下，建议在 feature 分支上进行 Squash 操作，然后在合并 feature 分支时，将 Squash 后的提交合并到主分支。
- 谨慎使用强制推送: 强制推送会覆盖远程仓库的提交历史，请务必谨慎使用，并与团队成员沟通。
- 备份重要分支: 在进行 Squash 操作之前，建议备份您的分支，以防操作失误导致数据丢失。您可以使用
git branch <branch_name> <commit_hash>命令创建一个新的分支来备份。 - 理解变基的原理: Squash 操作实际上是基于变基（rebase）实现的，理解变基的原理可以帮助您更好地使用 Squash。
七、总结
Git Squash 是一个强大的工具，可以帮助您保持 commit 历史的整洁和可读性。通过将多个细碎的提交合并成一个有意义的提交，您可以提高代码审查效率、简化问题追踪、更好地表达提交意图。
本文详细介绍了 Git Squash 的概念、使用场景、操作方法以及注意事项。希望通过本文的讲解，您已经掌握了 Git Squash 的基本用法，并能在实际开发中灵活运用这项技巧。请记住，在进行 Squash 操作时，务必谨慎，特别是在共享分支上，并与团队成员保持沟通。
通过合理使用 Git Squash，您的 Git 提交历史将变得更加清晰、专业，为您的开发工作带来便利。