合并最近 N 个 Git 提交：Squash 指南
合并最近 N 个 Git 提交：Squash 指南
Git 的强大之处在于其灵活的分支和合并策略，允许开发者以高度协作的方式进行代码开发。然而，频繁的提交可能会导致提交历史变得混乱，尤其是在进行小的、迭代式的更改时。为了保持提交历史的简洁和易于理解，Git 提供了 squash 命令，可以将多个提交合并成一个。本文将深入探讨如何使用 squash 命令合并最近的 N 个 Git 提交，并提供各种场景下的实际应用示例和最佳实践。
理解 Squash 合并
Squash 合并是一种将一系列提交合并成单个提交的方法。它不像普通的合并那样保留每个单独提交的记录，而是将所有更改组合成一个新的提交，并允许你为这个新的提交编写新的提交信息。这对于清理分支历史、简化代码审查以及创建更具逻辑性的提交历史非常有用。
使用 rebase 进行 Squash 合并
最常用的 squash 方法是使用 git rebase -i (interactive rebase) 命令。它允许你交互式地编辑提交历史，包括合并、重新排序和修改提交信息。
以下是合并最近 N 个提交的步骤：
-
确定要合并的提交数量 (N): 例如，要合并最近 3 个提交，可以使用
git log -n 3查看最近的提交历史，并记下目标提交的哈希值。 -
启动交互式 rebase: 使用
git rebase -i HEAD~N命令，其中 N 是要合并的提交数量。例如，要合并最近 3 个提交，使用git rebase -i HEAD~3。 -
编辑 rebase 指令: 执行上述命令后，会打开一个文本编辑器，其中列出了要 rebase 的提交，以及每个提交对应的操作指令。默认指令是
pick，表示保留该提交。要进行 squash 合并，需要将除第一个提交之外的其他提交的指令从pick改为squash或fixup。squash: 将当前提交合并到前一个提交，并允许你编辑合并后的提交信息。fixup: 将当前提交合并到前一个提交，并丢弃当前提交的提交信息，直接使用前一个提交的信息。
例如：
pick a1b2c3d 第一个提交
squash e4f5g6h 第二个提交
squash i7j8k9l 第三个提交 -
保存并关闭编辑器: 保存并关闭编辑器后，Git 会根据你的指令执行 rebase 操作。如果使用了
squash，会打开另一个编辑器，让你编辑合并后的提交信息。你可以选择保留第一个提交的信息，或者编写一个新的提交信息，概括所有合并的更改。 -
完成 rebase: 保存提交信息后，rebase 完成，最近的 N 个提交就被合并成了一个。
示例：合并最近 2 个提交
假设你的提交历史如下：
* commit c3: 修改文档
* commit c2: 添加新功能
* commit c1: 初始提交
你想将 c2 和 c3 合并成一个提交。
-
执行
git rebase -i HEAD~2。 -
编辑器打开后，修改内容如下：
pick c2 添加新功能
squash c3 修改文档
-
保存并关闭编辑器。
-
另一个编辑器打开，允许你编辑合并后的提交信息。你可以修改为：
添加新功能并修改文档
- 保存并关闭编辑器。现在
c2和c3就被合并成一个提交了，新的提交历史如下：
* commit c2': 添加新功能并修改文档
* commit c1: 初始提交
强制推送到远程分支 (谨慎使用)
如果已经将要 squash 的提交推送到远程分支，则需要强制推送才能更新远程分支。使用 git push --force-with-lease 命令强制推送。--force-with-lease 比 --force 更安全，因为它会在推送之前检查远程分支是否已经被其他人修改过。如果已经被修改，则会拒绝推送，防止数据丢失。
最佳实践
- 尽早 Squash: 最好在开发的早期阶段就进行 squash，避免在后期处理大量的提交。
- 保持原子性: 每个提交应该代表一个独立的逻辑单元。将相关的更改合并在一起，可以提高代码的可读性和可维护性。
- 清晰的提交信息: 合并后的提交信息应该清晰地描述所有合并的更改。
- 谨慎使用强制推送: 强制推送会改写历史，可能会对其他开发者造成影响。在强制推送之前，确保你理解其潜在的风险，并与团队成员沟通。
- 避免在公共分支上 Squash: 避免在
main或其他公共分支上进行 squash，因为这会改写共享的历史记录，可能导致与其他开发者的冲突。
其他 Squash 相关命令
除了 rebase -i，还有一些其他的命令可以用来进行 squash 操作：
git merge --squash: 将另一个分支的更改合并到当前分支，但不会创建新的合并提交。你需要手动提交合并后的更改。git reset --soft HEAD~N: 将 HEAD 指针回退 N 个提交，并将更改保留在暂存区。然后你可以使用git commit创建一个新的提交，包含所有更改。
总结
squash 命令是 Git 中一个强大的工具，可以帮助你维护干净、易于理解的提交历史。通过合理地使用 squash，可以提高代码的可读性、可维护性和协作效率。理解 rebase -i 的工作原理以及相关的最佳实践，可以让你更好地利用 squash 的优势，并避免潜在的风险。 选择合适的 squash 方法取决于你的具体需求和工作流程。 记住，在使用任何会改写历史的 Git 命令时，都要谨慎操作，并与团队成员充分沟通。