版本控制与协作 / 系统课时
执行本地分支变基
执行本地分支变基
学习目标
完成本课后,你将能够:
- 把本地功能分支变基到最新主分支
- 按顺序验证重新应用的提交
- 在变基前后检查工作区和测试
问题背景或应用场景
理解概念后,需要建立可重复的操作流程。安全的本地变基要求主分支引用足够新、功能分支尚未共享、工作区干净,并在完成后重新运行测试。
核心原理
变基的目标分支应代表新基线。常见流程是先更新本地 main,再切换功能分支执行 git rebase main。Git 会按原顺序重新应用功能分支独有提交;每个提交都可能单独产生冲突。
变基成功只说明补丁可以应用,不代表业务逻辑一定正确。主分支变化可能改变接口或行为,因此必须执行测试、构建和差异检查。
基础用法
开始前执行 git status,确保没有未提交修改。变基后使用 git log main..feature --format=%s --reverse 检查功能提交顺序,并与主分支共同运行测试。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。
bash
rm -rf git-local-rebase-demo
mkdir git-local-rebase-demo
cd git-local-rebase-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "base
" > base.txt
git add base.txt
git commit -q -m "feat: base"
git switch -q -c feature
printf "step one
" > feature.txt
git add feature.txt
git commit -q -m "feat: feature step one"
printf "step two
" >> feature.txt
git add feature.txt
git commit -q -m "feat: feature step two"
git switch -q main
printf "main update
" > main.txt
git add main.txt
git commit -q -m "feat: main update"
git switch -q feature
git rebase -q main
printf "feature-commits:
"
git log main..feature --format=%s --reverse
printf "file:
"
cat feature.txt预期输出
text
feature-commits:
feat: feature step one
feat: feature step two
file:
step one
step twoTips
- 变基前先备份分支可降低心理和操作风险。
- 每解决一个冲突都检查当前补丁意图。
- 完成后使用
--force-with-lease仅限明确需要更新自己已推送的分支。
常见错误
1. 目标 main 未更新
- 错误表现:变基完成后仍缺少远程最新提交。
- 产生原因:使用了过期本地主分支。
- 正确处理:先 fetch 并快进本地 main。
- 修复结果:功能分支基于最新主线。
2. 变基完成后不测试
- 错误表现:历史线性但功能异常。
- 产生原因:只验证命令成功,没有验证业务兼容性。
- 正确处理:重新执行测试和构建。
- 修复结果:代码与新基线共同工作。
本课练习
1. 变基两提交功能分支
- 任务目标:练习标准流程。
- 输入或初始条件:功能分支有两个提交,main 有一个新提交。
- 实现要求:变基并检查顺序。
- 验收条件:main 成为 feature 祖先。
2. 建立备份分支
- 任务目标:练习安全措施。
- 输入或初始条件:准备执行本地变基。
- 实现要求:先创建
feature-backup。 - 验收条件:失败时能从备份恢复。
3. 比较变基差异
- 任务目标:验证内容保持。
- 输入或初始条件:记录变基前与 main 的最终 diff。
- 实现要求:变基后再次比较。
- 验收条件:两次最终文件差异一致。
按自己的节奏,确认真正理解。