git rebase -i 是 Git 中一个非常强大且常用的命令，用于交互式地改写提交历史。它允许你对一系列提交进行编辑、合并、重排序、修改信息等操作，从而让项目历史更加清晰、整洁。

命令基本语法

git rebase -i <base-commit>

或者使用相对引用：

git rebase -i HEAD~n

• <base-commit>：你想要从哪个提交开始进行变基（不包含该提交）。
• HEAD~n：表示从当前提交往前数 n 个提交。例如 HEAD~3 表示最近的 3 个提交。

执行后会打开默认编辑器，列出指定范围内的提交，并允许你选择操作。

示例：编辑最近 3 个提交

git rebase -i HEAD~3

执行后，编辑器中会显示类似内容：

pick abc1234 Add login form
pick def5678 Fix typo in login
pick ghi8901 Add validation

每一行代表一个提交，格式为：

命令 SHA 提交信息

可以修改“命令”列来控制每个提交的处理方式。

支持的操作命令（Commands）

常见使用场景

1. 合并多个提交为一个（Squash）

将零碎的“修复”提交合并到主提交中：

pick abc1234 Add user profile page
squash def5678 Fix styling
squash ghi8901 Update avatar size

保存后，Git 会弹出编辑器让你输入合并后的提交信息。

2. 修改旧提交的信息

pick abc1234 Add login form
reword def5678 Fix typo in login ← 修改这行
pick ghi8901 Add validation

保存后，会进入另一个编辑器让你修改 def5678 的提交信息。

3. 修改某个提交的内容（edit）

pick abc1234 Add login form
edit def5678 Fix typo in login ← 改为 edit
pick ghi8901 Add validation

保存后，Git 会在 def5678 处暂停。此时可以：

# 修改文件
git add .
git commit --amend # 修改提交内容
git rebase --continue

可用于拆分提交：在 edit 阶段使用 git reset HEAD~1，然后分批添加并提交。

4. 删除错误提交

直接将某行改为 drop，或删除该行：

pick abc1234 Add feature
drop def5678 Accidental debug log
pick ghi8901 Add tests

注意事项与最佳实践

不要对已推送的公共分支使用 rebase -i

• 如果提交已经推送到远程且他人基于它工作，改写历史会导致冲突和混乱。
• 只应在本地未共享的提交上使用。

使用 --force-with-lease 谨慎推送

git push --force-with-lease

比 --force 更安全，避免覆盖他人提交。

随时可以中断或继续

• 中断变基：git rebase --abort
• 继续变基：git rebase --continue
• 查看状态：git rebase --show-current

建议在功能分支上操作

• 在 feature 分支上整理好历史后再合并到 main。

rebase -i vs merge

总结

git rebase -i 是 Git 高级用户的必备技能，适合用于：

• 提交前清理本地历史
• 合并零散提交
• 修正错误提交信息或内容
• 保持项目历史清晰专业

口诀：“本地用 rebase，共享用 merge”