Git rebase --autosquash 怎样整理修复提交

整理一个已经提交的功能时，修复往往晚于目标提交出现。如果直接手动编辑交互式 rebase 列表，容易把修复行放错位置。Git 的 --autosquash 可以根据 fixup! 提交说明自动调整 todo 顺序，再把修复内容并入目标提交。官方文档地址：https://git-scm.com/docs/git-rebase

第 1 步：确认目标提交与整理范围

先在功能分支上查看最近历史，目标提交是“希望保留一个干净提交”的那一条，基线则是它的父提交或更早的公共起点。工作区有未保存改动时先暂存或提交，避免 rebase 把无关修改带入过程。

# 查看最近提交，确认目标提交的短 SHA 和顺序
git log --oneline --decorate -8

# 检查工作区是否干净，避免把无关改动带进整理过程
git status --short

例如历史中有 a1b2c3d Add parser guard，后面又有一次修正，那么目标提交就是 a1b2c3d。本教程假定当前分支只整理自己的本地提交；已经推送并被他人依赖的公共分支不要直接改写。

第 2 步：先把修复提交标记给目标提交

完成修正后，把变更加入暂存区，并使用目标提交的短 SHA 创建 fixup 提交。命令中的 SHA 必须指向目标提交，不是刚刚产生的修复提交。

# 将本次修正加入暂存区，提交范围只覆盖目标问题
git add path/to/parser.go

# 让 Git 生成带 fixup! 前缀的提交说明
git commit --fixup=a1b2c3d

# 确认修复提交已经指向目标提交
git log --oneline --decorate -4

成功标志是最新提交类似 fixup! Add parser guard，并且目标提交仍位于它之前。Git 会从提交说明中识别这个关系；不要手工把普通提交改名成看似匹配的文本后就跳过检查。

第 3 步：执行 autosquash 交互式 rebase

现在从目标提交的父提交开始整理。若目标提交是 a1b2c3d，可以把基线写成 a1b2c3d^。打开 todo 列表后，--autosquash 会把 fixup 行移动到目标提交后面，并把动作改为 fixup；先检查顺序，再保存退出。

# 从目标提交的父提交开始打开交互式 rebase
git rebase -i --autosquash a1b2c3d^

# 若需要指定更早的基线，可先用 log 找到公共起点再替换上面的参数
git log --oneline --decorate --graph -8

如果使用支持交互式 rebase 的 Git 图形客户端，对应路径通常是“History → 选中目标提交 → Interactive Rebase”，在面板中勾选“Auto-squash”。界面名称会因客户端而变，命令行参数才是这里的确定边界。

todo 列表中的 fixup 会丢弃修复提交的说明文字，只保留它的内容；若希望保留并编辑两条提交说明，应改用 --squash，不要把两者混用。

第 4 步：保存后核对整理结果

保存 todo 列表后，Git 会重放提交并生成新的提交 ID。先看状态，再看历史和差异；不要只凭编辑器关闭就认为操作成功。

# 查看整理后的提交数量和说明，确认 fixup 行已消失
git log --oneline --decorate --graph -6

# 确认没有未提交文件或未完成的 rebase 状态
git status

# 对比整理前后仍需保留的功能差异
git diff HEAD^ HEAD -- path/to/parser.go

预期状态是历史里只剩一个内容完整的目标提交，修复提交不再单独出现，git status 显示工作区干净。若发生冲突，解决文件后执行 git add 再运行 git rebase --continue；无法接受当前改写时用 git rebase --abort 回到开始前的分支状态。

常见问题

没有写 fixup! 前缀也能用 autosquash 吗？

不能自动建立可靠归属。请优先用 git commit --fixup=，不要依赖手工改写说明。

为什么 rebase 后提交 SHA 变了？

rebase 会重放提交并生成新的父子关系，提交 ID 改变是正常结果；重点检查内容、顺序和分支指向。

远程分支已经推送还能直接 autosquash 吗？

本地可以整理，但后续推送通常涉及强制更新和协作约定。先确认分支没有被他人继续开发，再按团队规则处理远程更新。

把“目标提交 → fixup 提交 → autosquash → 历史核对”固定成一条流程，就能把零散修复收敛到正确提交，同时保留清晰的回退点。