版本控制与协作 / 系统课时
同步前先更新本地主分支
同步前先更新本地主分支
学习目标
完成本课后,你将能够:
- 建立 fetch、检查、快进的同步顺序
- 从最新主分支创建功能分支
- 减少长期分叉导致的冲突
问题背景或应用场景
很多冲突并非不可避免,而是功能分支从过期主分支创建、长期不更新造成的。团队成员开始新任务前,应先让本地主分支与远程主分支保持一致,再创建功能分支。
核心原理
推荐流程是先获取远程引用,切换本地 main,使用 git merge --ff-only origin/main 快进,再创建功能分支。--ff-only 可以保证本地主分支没有混入独有提交;如果不能快进,应先调查本地为何分叉。
同步频率取决于团队变更速度。频繁小范围整合通常比临近合并时一次处理大量冲突更容易,但也要在稳定节点进行,避免打断未完成工作。
基础用法
开始任务前依次执行 git fetch origin、git switch main、git merge --ff-only origin/main、git switch -c feature/<name>。已有未完成修改时先提交或 stash。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。
bash
rm -rf git-sync-main-demo
mkdir git-sync-main-demo
cd git-sync-main-demo
git init -q -b main alice
git -C alice config user.name "Alice"
git -C alice config user.email "alice@example.com"
printf "version=1
" > alice/app.txt
git -C alice add app.txt
git -C alice commit -q -m "feat: version 1"
git init -q --bare remote.git
git -C alice remote add origin ../remote.git
git -C alice push -q -u origin main
git -C remote.git symbolic-ref HEAD refs/heads/main
git clone -q remote.git bob
git -C bob config user.name "Bob"
git -C bob config user.email "bob@example.com"
printf "version=2
" > alice/app.txt
git -C alice add app.txt
git -C alice commit -q -m "feat: version 2"
git -C alice push -q
git -C bob fetch -q origin
git -C bob merge -q --ff-only origin/main
git -C bob switch -q -c feature/report
printf "report
" > bob/report.txt
git -C bob add report.txt
git -C bob commit -q -m "feat: add report"
printf "main-file: "
git -C bob show main:app.txt
printf "current-branch: "
git -C bob branch --show-current预期输出
text
main-file: version=2
current-branch: feature/reportTips
- 不要直接在本地主分支开发业务提交。
- 不能快进时先查明本地主分支独有提交来源。
- 功能分支开发周期较长时定期获取并整合主线。
常见错误
1. 从过期 main 创建分支
- 错误表现:合并时出现大量早已解决的冲突。
- 产生原因:开始任务前没有获取远程更新。
- 正确处理:更新本地 main 后重新变基或创建分支。
- 修复结果:功能分支基于最新主线。
2. 在 main 上保留个人提交
- 错误表现:主分支无法快进远程。
- 产生原因:把功能开发直接提交到本地 main。
- 正确处理:将提交迁移到功能分支,恢复 main 跟踪远程。
- 修复结果:本地主分支保持镜像角色。
本课练习
1. 标准同步后建分支
- 任务目标:练习完整顺序。
- 输入或初始条件:远程 main 领先本地。
- 实现要求:获取、快进、创建功能分支。
- 验收条件:新分支包含远程最新提交。
2. 诊断不能快进
- 任务目标:处理异常主分支。
- 输入或初始条件:本地 main 有独有提交。
- 实现要求:列出双方独有历史。
- 验收条件:能决定迁移提交或重置策略。
3. 长分支定期更新
- 任务目标:减少最终冲突。
- 输入或初始条件:功能分支持续多天。
- 实现要求:每天获取并小步整合。
- 验收条件:最终合并冲突数量可控。
按自己的节奏,确认真正理解。