版本控制与协作 / 系统课时
拉取并整合远程提交
拉取并整合远程提交
学习目标
完成本课后,你将能够:
- 说明 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 2Tips
- 团队未明确策略时,优先使用
--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。
- 验收条件:能比较工作区和本地分支指针的不同。
按自己的节奏,确认真正理解。