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

同步前先更新本地主分支

同步前先更新本地主分支

学习目标

完成本课后,你将能够:

  • 建立 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/report

Tips

  • 不要直接在本地主分支开发业务提交。
  • 不能快进时先查明本地主分支独有提交来源。
  • 功能分支开发周期较长时定期获取并整合主线。

常见错误

1. 从过期 main 创建分支

  • 错误表现:合并时出现大量早已解决的冲突。
  • 产生原因:开始任务前没有获取远程更新。
  • 正确处理:更新本地 main 后重新变基或创建分支。
  • 修复结果:功能分支基于最新主线。

2. 在 main 上保留个人提交

  • 错误表现:主分支无法快进远程。
  • 产生原因:把功能开发直接提交到本地 main。
  • 正确处理:将提交迁移到功能分支,恢复 main 跟踪远程。
  • 修复结果:本地主分支保持镜像角色。

本课练习

1. 标准同步后建分支

  • 任务目标:练习完整顺序。
  • 输入或初始条件:远程 main 领先本地。
  • 实现要求:获取、快进、创建功能分支。
  • 验收条件:新分支包含远程最新提交。

2. 诊断不能快进

  • 任务目标:处理异常主分支。
  • 输入或初始条件:本地 main 有独有提交。
  • 实现要求:列出双方独有历史。
  • 验收条件:能决定迁移提交或重置策略。

3. 长分支定期更新

  • 任务目标:减少最终冲突。
  • 输入或初始条件:功能分支持续多天。
  • 实现要求:每天获取并小步整合。
  • 验收条件:最终合并冲突数量可控。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

同步前先更新本地主分支

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

登录哪都通