版本控制与协作 / 系统课时

交互式整理本地提交

交互式整理本地提交

学习目标

完成本课后,你将能够:

  • 使用交互式变基查看提交计划
  • 合并和修改本地提交
  • 保持整理范围只覆盖未共享历史

问题背景或应用场景

开发过程中可能产生“临时修复”“补一个文件”等碎片提交。合并前可以用交互式变基整理说明、顺序和粒度,让评审者看到清晰历史。

核心原理

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: 2

Tips

  • 先创建备份分支再整理。
  • 提交计划按从旧到新排列。
  • 整理后检查每个提交的 diff,而不只看最终文件。

常见错误

1. 选错重写范围

  • 错误表现:基础提交也被改写。
  • 产生原因:HEAD~n 数量估算错误。
  • 正确处理:先用日志确认基线,必要时使用明确提交。
  • 修复结果:只整理目标本地提交。

2. 把 squash 当删除变化

  • 错误表现:合并后文件变化仍存在。
  • 产生原因:squash 合并提交,不丢弃补丁。
  • 正确处理:检查最终 diff 和新提交内容。
  • 修复结果:历史变少但功能变化完整保留。

本课练习

1. 修改提交说明

  • 任务目标:练习 reword。
  • 输入或初始条件:最近两个提交中一个说明模糊。
  • 实现要求:交互式变基修改说明。
  • 验收条件:文件不变,日志说明更新。

2. 合并修补提交

  • 任务目标:练习 squash。
  • 输入或初始条件:一个功能提交后紧跟修补提交。
  • 实现要求:合并为一个提交。
  • 验收条件:最终 diff 不变,提交数量减少。

3. 调整提交顺序

  • 任务目标:理解依赖风险。
  • 输入或初始条件:两个独立文件提交顺序不理想。
  • 实现要求:交换计划行顺序。
  • 验收条件:历史顺序改变且测试通过。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

交互式整理本地提交

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通