如何将多次提交压缩为一个新的提交

727 阅读3分钟

在Git中,将多次提交压缩成一次提交通常被称为"压缩提交历史"或"交互式变基"。这在代码审查、合并分支或保持干净的提交历史时非常有用。以下是具体步骤和常用方法:

一、使用 git rebase -i 交互式变基

场景:将最近的多个提交压缩为一个。
步骤

  1. 确定需要压缩的提交范围
    git log --oneline  # 查看提交历史,确定需要压缩的提交起点
    
  2. 启动交互式变基(例如,压缩最近3个提交):
    git rebase -i HEAD~3  # 压缩最近3个提交(包括HEAD)
    
    或指定具体的提交哈希:
    git rebase -i <commit-hash>  # 压缩<commit-hash>之后的所有提交
    
  3. 在编辑器中修改提交指令
    将需要压缩的提交前的 pick 改为 squashs,保留第一个提交为 pick
    pick e1f5a2d 初始提交
    s 3d7f4b9 添加功能A
    s 5c8d6e7 修复功能A的Bug
    
  4. 保存并退出编辑器,Git会合并提交并提示你编辑合并后的提交信息。
  5. 强制推送至远程分支(如果已推送到远程):
    git push -f origin <branch-name>  # 注意:强制推送会覆盖远程历史!
    

二、将多个提交压缩为一个新提交

场景:彻底丢弃原有提交信息,创建全新提交。
步骤

  1. 将当前分支重置到目标提交
    git reset --soft <commit-hash>  # 保留所有修改,但回到<commit-hash>状态
    
  2. 提交所有修改为一个新提交
    git commit -m "合并多个提交:完成功能X"
    
  3. 强制推送至远程分支(如果已推送到远程):
    git push -f origin <branch-name>
    

三、合并特定分支的多次提交为一次

场景:将feature分支的多个提交合并到main分支时,只保留一个合并提交。
步骤

  1. 切换到目标分支(如main)
    git checkout main
    
  2. 使用 --squash 选项合并分支
    git merge --squash feature-branch  # 将feature分支的修改合并到当前分支,但不创建提交
    
  3. 提交合并结果
    git commit -m "合并feature-branch:完成功能Y"
    
  4. 推送到远程
    git push origin main
    

四、注意事项

  1. 不要修改已共享的提交
    如果提交已推送到公共分支(如main)并被他人使用,强制修改历史会导致协作冲突。建议仅在私有分支上压缩提交。

  2. 备份分支
    在执行变基前,创建备份分支以防意外:

    git branch backup-branch  # 创建当前分支的备份
    
  3. 冲突处理
    如果压缩过程中出现冲突,按以下步骤解决:

    git status  # 查看冲突文件
    # 手动解决冲突
    git add <resolved-file>  # 标记冲突已解决
    git rebase --continue  # 继续变基
    
  4. 查看提交历史
    使用 git log --graph --oneline 检查压缩后的提交历史是否符合预期。

五、面试延伸问题

  1. 为什么压缩提交历史很重要?
    → 保持清晰的提交历史,便于代码审查和回溯。

  2. git rebase -igit merge --squash 的区别是什么?
    rebase -i 会修改提交历史,而 merge --squash 会创建新的合并提交,保留原分支结构。

  3. 如何撤销一个已完成的 git rebase
    → 使用 git reflog 找到变基前的HEAD位置,然后 git reset --hard <commit-hash>

六、示例场景

假设你有以下提交历史:

e1f5a2d (HEAD) 修复样式问题
3d7f4b9 添加登录功能
5c8d6e7 初始项目结构

执行 git rebase -i HEAD~3 后,将后两个提交压缩为一个,最终历史变为:

5c8d6e7 (HEAD) 初始项目结构并添加登录功能

通过合理压缩提交,可使代码仓库的历史更加整洁、易读。