版本控制与协作 / 系统课时
交互式整理本地提交
交互式整理本地提交
学习目标
完成本课后,你将能够:
- 使用交互式变基查看提交计划
- 合并和修改本地提交
- 保持整理范围只覆盖未共享历史
问题背景或应用场景
开发过程中可能产生“临时修复”“补一个文件”等碎片提交。合并前可以用交互式变基整理说明、顺序和粒度,让评审者看到清晰历史。
核心原理
git rebase -i <基线> 会打开提交计划。pick 保留,reword 修改说明,squash 合并并编辑说明,fixup 合并但通常丢弃后一个说明,还可以调整行顺序。计划从旧到新排列,操作结果会产生新提交哈希。
交互式整理适合本地未共享提交。范围选择错误可能重写过多历史,因此执行前先用 git log --oneline <基线>..HEAD 确认目标集合,并创建备份分支。
基础用法
常用命令为 git rebase -i HEAD~3。本课示例通过临时编辑器脚本自动把第二个提交改为 squash,便于在无交互环境中验证原理;真实使用时应在编辑器中人工审查计划。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。
bash
rm -rf git-interactive-rebase-demo
mkdir git-interactive-rebase-demo
cd git-interactive-rebase-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "base
" > app.txt
git add app.txt
git commit -q -m "feat: base"
printf "title
" >> app.txt
git add app.txt
git commit -q -m "feat: add title"
printf "details
" >> app.txt
git add app.txt
git commit -q -m "fixup: add details"
cat > sequence-editor.sh <<'EOF'
#!/usr/bin/env bash
sed -i.bak '2s/^pick/squash/' "$1"
EOF
chmod +x sequence-editor.sh
GIT_SEQUENCE_EDITOR="$PWD/sequence-editor.sh" GIT_EDITOR=true git rebase -q -i HEAD~2 >/dev/null 2>&1
printf "history:
"
git log --format=%s --reverse
printf "commit-count: "
git rev-list --count HEAD预期输出
text
history:
feat: base
feat: add title
commit-count: 2Tips
- 先创建备份分支再整理。
- 提交计划按从旧到新排列。
- 整理后检查每个提交的 diff,而不只看最终文件。
常见错误
1. 选错重写范围
- 错误表现:基础提交也被改写。
- 产生原因:
HEAD~n数量估算错误。 - 正确处理:先用日志确认基线,必要时使用明确提交。
- 修复结果:只整理目标本地提交。
2. 把 squash 当删除变化
- 错误表现:合并后文件变化仍存在。
- 产生原因:squash 合并提交,不丢弃补丁。
- 正确处理:检查最终 diff 和新提交内容。
- 修复结果:历史变少但功能变化完整保留。
本课练习
1. 修改提交说明
- 任务目标:练习 reword。
- 输入或初始条件:最近两个提交中一个说明模糊。
- 实现要求:交互式变基修改说明。
- 验收条件:文件不变,日志说明更新。
2. 合并修补提交
- 任务目标:练习 squash。
- 输入或初始条件:一个功能提交后紧跟修补提交。
- 实现要求:合并为一个提交。
- 验收条件:最终 diff 不变,提交数量减少。
3. 调整提交顺序
- 任务目标:理解依赖风险。
- 输入或初始条件:两个独立文件提交顺序不理想。
- 实现要求:交换计划行顺序。
- 验收条件:历史顺序改变且测试通过。
按自己的节奏,确认真正理解。