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

执行本地分支变基

执行本地分支变基

学习目标

完成本课后,你将能够:

  • 把本地功能分支变基到最新主分支
  • 按顺序验证重新应用的提交
  • 在变基前后检查工作区和测试

问题背景或应用场景

理解概念后,需要建立可重复的操作流程。安全的本地变基要求主分支引用足够新、功能分支尚未共享、工作区干净,并在完成后重新运行测试。

核心原理

变基的目标分支应代表新基线。常见流程是先更新本地 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 two

Tips

  • 变基前先备份分支可降低心理和操作风险。
  • 每解决一个冲突都检查当前补丁意图。
  • 完成后使用 --force-with-lease 仅限明确需要更新自己已推送的分支。

常见错误

1. 目标 main 未更新

  • 错误表现:变基完成后仍缺少远程最新提交。
  • 产生原因:使用了过期本地主分支。
  • 正确处理:先 fetch 并快进本地 main。
  • 修复结果:功能分支基于最新主线。

2. 变基完成后不测试

  • 错误表现:历史线性但功能异常。
  • 产生原因:只验证命令成功,没有验证业务兼容性。
  • 正确处理:重新执行测试和构建。
  • 修复结果:代码与新基线共同工作。

本课练习

1. 变基两提交功能分支

  • 任务目标:练习标准流程。
  • 输入或初始条件:功能分支有两个提交,main 有一个新提交。
  • 实现要求:变基并检查顺序。
  • 验收条件:main 成为 feature 祖先。

2. 建立备份分支

  • 任务目标:练习安全措施。
  • 输入或初始条件:准备执行本地变基。
  • 实现要求:先创建 feature-backup。
  • 验收条件:失败时能从备份恢复。

3. 比较变基差异

  • 任务目标:验证内容保持。
  • 输入或初始条件:记录变基前与 main 的最终 diff。
  • 实现要求:变基后再次比较。
  • 验收条件:两次最终文件差异一致。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

执行本地分支变基

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

登录哪都通