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

拉取并整合远程提交

拉取并整合远程提交

学习目标

完成本课后,你将能够:

  • 说明 git pull 的两个阶段
  • 使用快进方式同步远程提交
  • 在拉取前检查本地修改和分支关系

问题背景或应用场景

当目标明确是让当前分支同步其上游分支时,可以使用 git pull 把获取与整合连续完成。它操作简洁,但也可能触发合并提交、变基或冲突,因此执行前必须了解当前分支的上游关系和本地状态。

核心原理

git pull 先执行获取,再根据参数或配置执行合并或变基。git pull --ff-only 只允许快进更新;只要本地存在独有提交导致分叉,它就会拒绝,而不会自动创建合并提交。这是初学阶段较安全、行为明确的同步方式。

若团队采用变基工作流,可使用 git pull --rebase,但它会改写本地未推送提交的标识。工作区有未提交修改时,拉取可能被阻止或需要自动暂存选项;更稳妥的做法是先提交、暂存到 stash,或明确丢弃修改。

基础用法

先执行 git status -sb 确认当前分支与工作区,再使用 git pull --ff-only。如果提示无法快进,应先 git fetch 并检查双方独有提交,不要立即使用强制命令。

完整可运行示例

以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。

bash
rm -rf git-pull-demo
mkdir git-pull-demo
cd git-pull-demo
git init -q -b main source
git -C source config user.name "Source User"
git -C source config user.email "source@example.com"
printf "version=1
" > source/app.conf
git -C source add app.conf
git -C source commit -q -m "feat: version 1"
git init -q --bare remote.git
git -C source remote add origin ../remote.git
git -C source push -q -u origin main
git -C remote.git symbolic-ref HEAD refs/heads/main
git clone -q remote.git workspace
printf "version=2
" > source/app.conf
git -C source add app.conf
git -C source commit -q -m "feat: version 2"
git -C source push -q
git -C workspace pull -q --ff-only
printf "file: "
cat workspace/app.conf
printf "history: "
git -C workspace log --format=%s --reverse | awk 'BEGIN{ORS=""} {if(NR>1) printf " | "; printf "%s", $0} END{print ""}'

预期输出

text
file: version=2
history: feat: version 1 | feat: version 2

Tips

  • 团队未明确策略时,优先使用 --ff-only,避免无意生成合并提交。
  • 拉取失败后先查看分叉情况,不要直接执行 reset --hard。
  • 把 pull 理解为组合命令,有助于单独排查获取或整合阶段。

常见错误

1. 在错误分支执行 pull

  • 错误表现:本想更新 main,却把远程变化整合进功能分支。
  • 产生原因:未检查当前分支。
  • 正确处理:先执行 git branch --show-current 和 git status -sb。
  • 修复结果:远程更新进入正确目标分支。

2. 分叉后反复 pull

  • 错误表现:每次拉取都继续产生冲突或额外合并提交。
  • 产生原因:没有先明确 merge、rebase 或放弃本地提交的策略。
  • 正确处理:先 fetch,检查双方提交,再选择一种整合方式。
  • 修复结果:历史结构可预测,冲突只处理一次。

本课练习

1. 快进拉取

  • 任务目标:练习最安全的同步。
  • 输入或初始条件:远程领先本地一个提交,本地无独有提交。
  • 实现要求:执行 git pull --ff-only。
  • 验收条件:当前分支和文件均更新到远程版本。

2. 制造分叉并诊断

  • 任务目标:理解不能快进的原因。
  • 输入或初始条件:本地和远程分别新增一个提交。
  • 实现要求:尝试 --ff-only 并检查双方独有提交。
  • 验收条件:能说明拒绝原因,不强行覆盖任何一方。

3. 比较 pull 与 fetch

  • 任务目标:观察组合命令差异。
  • 输入或初始条件:准备两个相同克隆。
  • 实现要求:一个只 fetch,另一个 pull。
  • 验收条件:能比较工作区和本地分支指针的不同。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

拉取并整合远程提交

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

登录哪都通