用 git rebase -i 整理提交历史:改信息、合并、重排
# 用 git rebase -i 整理提交历史:改信息、合并、重排
## 前言
提交历史是写给人看的。但在日常开发里,历史常常变成这样:
```
fix bug
fix again
wip
修改
update
真正修好了
```
这些信息对三个月后排查问题毫无帮助。更麻烦的是,有些提交里混进了不该有的调试代码,或者一个功能被拆成了五六个零碎提交。
`git rebase -i`(交互式变基)就是用来收拾这些的。它能改提交信息、把多个提交合并成一个、调整顺序、删掉某个提交。本文讲它最常用的三个场景,以及每个场景里的注意事项。
## 一、基本用法
```bash
git rebase -i HEAD~3
```
这条命令表示「对最近 3 个提交做交互式整理」。执行后会打开编辑器,内容类似:
```
pick a1b2c3d 添加用户登录接口
pick d4e5f6g 补充参数校验
pick h7i8j9k 修复拼写错误
```
每一行前面的 `pick` 是动作指令。改成别的指令就执行别的操作。常用的有:
- `pick`:保留这个提交
- `reword`:保留,但改提交信息
- `squash`:合并到上一个提交,保留两条提交信息
- `fixup`:合并到上一个提交,丢弃这条的信息
- `drop`:删掉这个提交
改完保存退出,Git 就按顺序执行。
## 二、场景一:改提交信息
把目标行前面的 `pick` 改成 `reword`:
```
reword a1b2c3d 添加用户登录接口
pick d4e5f6g 补充参数校验
```
保存后会弹出第二个编辑器,让你写新的提交信息。写完保存即可。
**注意**:如果你要改的是最近一次提交,有个更省事的办法:
```bash
git commit --amend
```
它等于对 HEAD 单独做一次 reword,不用进交互界面。
## 三、场景二:把多个提交合并成一个
这是最常用的场景。比如你做登录功能时留下了三条提交,想合成一条「实现用户登录」:
```
pick a1b2c3d 添加用户登录接口
squash d4e5f6g 补充参数校验
squash h7i8j9k 修复拼写错误
```
保存后 Git 会把三条合并,并让你写一条新的提交信息(默认会把三条的原文都列出来,删掉不要的即可)。
如果不想要后两条的信息,用 `fixup` 更干净:
```
pick a1b2c3d 添加用户登录接口
fixup d4e5f6g 补充参数校验
fixup h7i8j9k 修复拼写错误
```
这样最终只有一条提交信息,就是第一条的。
### 一个省事的写法
如果你确定就是把最近 N 条合成一条,可以跳过编辑指令:
```bash
git reset --soft HEAD~3
git commit -m "实现用户登录"
```
`--soft` 会把提交撤掉但保留改动在暂存区,然后一次性提交。效果和 squash 一样,但少了几步。
## 四、场景三:调整顺序和删除提交
在编辑器里直接把行上下移动,就能改变提交顺序:
```
pick h7i8j9k 修复拼写错误
pick a1b2c3d 添加用户登录接口
```
**注意**:调整顺序可能引发冲突。比如把「修复拼写」挪到「添加接口」前面,而前者改的文件在后者里才被创建,那就会冲突。冲突时 Git 会停下来,解决后执行 `git rebase --continue`,或者放弃用 `git rebase --abort`。
删掉某行(或改成 `drop`)就移除那个提交。
## 五、最重要的一条:别对已推送的提交做变基
变基的本质是**用新的提交替换旧的提交**。那些旧提交的哈希值会变。
如果你要整理的提交已经推到远程、且别人可能基于它们工作,变基后再 push 会被拒绝,只能强推:
```bash
git push --force
```
这会把远程历史覆写掉。同事本地的分支会和远程对不上,他们得手动处理,很容易丢代码。
**判断标准很简单**:
- 只在你本地、没推过远程 → 放心变基
- 已推送,但确定没人基于它工作(比如你自己的 feature 分支)→ 可以变基,但用 `--force-with-lease` 而不是 `--force`
- 已经合入主干,或别人在基于它开发 → **不要变基**
`--force-with-lease` 会在强推前检查远程分支是否已经被别人更新过,如果有就拒绝,避免误覆盖别人的提交。这比裸 `--force` 安全得多。
```bash
git push --force-with-lease
```
## 六、出错了怎么回退
变基过程中随时可以放弃:
```bash
git rebase --abort
```
这会回到变基开始前的状态,什么都没改。
如果变基已经完成但结果不对,可以用 reflog 找回原来的位置:
```bash
git reflog
```
它会列出 HEAD 的所有移动记录,找到变基前的那个哈希,然后:
```bash
git reset --hard <那个哈希>
```
reflog 默认保留 90 天,所以即使变基完成一段时间了,通常也还救得回来。
## 小结
- 改信息用 `reword`,改最近一条直接用 `git commit --amend`
- 合并提交用 `squash`(保留信息)或 `fixup`(丢弃信息)
- 变基会改写历史,**已推送且别人在用的分支不要变基**
- 必须强推时用 `--force-with-lease`
- 出错就用 `git rebase --abort`,事后补救用 `git reflog`
整理提交历史的价值不在好看,而在于半年后有人(很可能就是你自己)需要知道「这行代码当时为什么这么改」的时候,能查得到。
- 点赞
- 收藏
- 关注作者
评论(0)