版本控制与协作 / 系统课时
解决变基过程中的冲突
解决变基过程中的冲突
学习目标
完成本课后,你将能够:
- 识别 rebase 暂停状态
- 逐个解决并继续重新应用提交
- 正确使用 continue、skip 与 abort
问题背景或应用场景
变基会逐个重新应用提交,所以同一轮操作可能多次暂停。每次冲突都对应当前正在应用的某个提交。必须理解该提交的目的,解决后继续,而不是把整个功能分支一次性当作普通合并处理。
核心原理
冲突时 git status 会显示正在变基以及当前步骤。解决文件并暂存后,执行 git rebase --continue 应用当前提交。--skip 会完全跳过当前提交,只有确认其变化已被新基线包含或不再需要时才能使用。--abort 返回变基开始前。
由于提交被重新创建,完成后的哈希会改变。若功能分支已推送,更新远程通常需要安全强制推送,但这必须符合团队规则。
基础用法
先查看当前提交说明和冲突文件,编辑最终内容,运行测试,git add 后执行 GIT_EDITOR=true git rebase --continue 或在编辑器中确认说明。每次继续后都重新查看状态。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。
bash
rm -rf git-rebase-conflict-demo
mkdir git-rebase-conflict-demo
cd git-rebase-conflict-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "mode=base
" > app.conf
git add app.conf
git commit -q -m "chore: add base config"
git switch -q -c feature
printf "mode=feature
" > app.conf
git add app.conf
git commit -q -m "feat: set feature mode"
git switch -q main
printf "mode=main
" > app.conf
git add app.conf
git commit -q -m "chore: set main mode"
git switch -q feature
if git rebase main >/dev/null 2>&1; then :; fi
printf "mode=main-feature
" > app.conf
git add app.conf
GIT_EDITOR=true git rebase --continue >/dev/null 2>&1
printf "file: "
cat app.conf
printf "history:
"
git log --format=%s --reverse预期输出
text
file: mode=main-feature
history:
chore: add base config
chore: set main mode
feat: set feature modeTips
- 每次冲突都确认当前正在应用哪个提交。
- 谨慎使用 skip,它会丢弃整个提交变化。
- 任何时刻方向不明确都可以 abort 后重新规划。
常见错误
1. 解决后执行 merge --continue
- 错误表现:Git 不识别当前流程。
- 产生原因:混淆 merge 与 rebase 状态。
- 正确处理:根据
git status使用git rebase --continue。 - 修复结果:当前变基步骤继续执行。
2. 随意使用 skip
- 错误表现:功能提交从最终历史消失。
- 产生原因:未确认补丁是否已被包含。
- 正确处理:先比较当前文件和目标提交差异。
- 修复结果:只有重复或无效提交才被跳过。
本课练习
1. 处理单次变基冲突
- 任务目标:练习完整流程。
- 输入或初始条件:功能和主分支修改同一行。
- 实现要求:变基、解决、继续。
- 验收条件:feature 线性建立在 main 之后。
2. 中止变基
- 任务目标:验证可恢复性。
- 输入或初始条件:变基产生复杂冲突。
- 实现要求:执行 abort。
- 验收条件:分支回到操作前提交。
3. 识别可跳过提交
- 任务目标:理解 skip 条件。
- 输入或初始条件:主分支已包含功能提交等价变化。
- 实现要求:验证后跳过。
- 验收条件:最终文件无缺失且历史不重复。
按自己的节奏,确认真正理解。