Git 合并最近 N 次提交方法汇总

技术背景

在使用 Git 进行版本控制时，随着开发的进行，可能会产生大量的小提交。这些小提交可能会让提交历史变得杂乱无章，不利于后续的代码审查和项目管理。为了保持提交历史的简洁性和可读性，我们常常需要将最近的 N 次提交合并成一个提交，即进行提交的压缩（squash）操作。

实现步骤

方法一：使用 git reset --soft

1. 确定要合并的提交数量 N：明确你想要将最近的多少次提交合并成一个。
2. 执行软重置操作：使用 git reset --soft HEAD~N 命令将 HEAD 指针回退 N 个提交，但保留工作区和暂存区的更改。
3. 创建新的提交：使用 git commit 命令创建一个新的提交，将之前 N 个提交的更改合并到这个新提交中。

示例代码：

# 合并最近 3 次提交
git reset --soft HEAD~3
git commit

方法二：使用 git rebase -i

1. 确定基准提交：使用 git rebase -i <after-this-commit> 命令打开交互式变基界面，其中 <after-this-commit> 是要合并的提交之前的那个提交。通常可以使用相对位置，如 HEAD~N 表示从当前 HEAD 往前数第 N 个提交。
2. 编辑提交指令：在打开的文本编辑器中，将除第一个提交外的其他提交的 pick 指令改为 squash 或 fixup。squash 会将该提交的更改合并到上一个提交，并保留提交信息；fixup 同样会合并更改，但会丢弃该提交的信息。
3. 保存并退出编辑器：完成编辑后，保存并退出编辑器，Git 会自动执行变基操作，将指定的提交合并。

示例代码：

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

方法三：使用 git merge --squash

1. 确保工作区干净：使用 git status 检查工作区是否有未提交的更改，如有需要先进行提交。
2. 重置分支：使用 git reset --hard HEAD~N 命令将当前分支重置到要合并的提交之前的那个提交。
3. 执行合并操作：使用 git merge --squash HEAD@{1} 命令将之前的提交更改合并到当前分支，但不创建新的提交。
4. 创建新的提交：使用 git commit 命令创建一个新的提交，将合并的更改保存。

示例代码：

# 合并最近 12 次提交
git reset --hard HEAD~12
git merge --squash HEAD@{1}
git commit

核心代码

方法一代码示例

# 合并最近 2 次提交，并指定新的提交信息
git reset --soft HEAD~2
git commit -m "合并最近 2 次提交"

方法二代码示例

# 合并最近 3 次提交
git rebase -i HEAD~3
# 在编辑器中修改指令，例如：
# pick 123abc 提交信息 1
# squash 456def 提交信息 2
# squash 789ghi 提交信息 3

方法三代码示例

# 合并最近 4 次提交
git reset --hard HEAD~4
git merge --squash HEAD@{1}
git commit

最佳实践

• 在本地分支操作：提交合并操作会重写提交历史，因此建议在本地分支进行操作，避免影响其他开发者。
• 备份重要提交：在进行提交合并之前，最好先备份重要的提交，以防误操作导致数据丢失。
• 清晰的提交信息：合并提交时，编写清晰、有意义的提交信息，方便后续的代码审查和维护。

常见问题

强制推送问题

由于提交合并会重写提交历史，当你将更改推送到远程仓库时，可能需要使用 --force 或 --force-with-lease 选项。但需要注意，强制推送可能会覆盖远程仓库的提交历史，影响其他开发者的工作，因此在多人协作的项目中要谨慎使用。

示例代码：

# 强制推送合并后的提交
git push --force origin <branch-name>
# 更安全的强制推送方式
git push --force-with-lease origin <branch-name>

合并冲突问题

在使用 git rebase -i 或 git merge --squash 进行提交合并时，可能会遇到合并冲突。此时需要手动解决冲突，然后使用 git add 命令将解决冲突后的文件添加到暂存区，最后使用 git rebase --continue 或 git commit 命令继续合并操作。

示例代码：

# 解决冲突后继续变基操作
git add <conflicted-file>
git rebase --continue