版本控制与协作 / 系统课时
获取远程更新
获取远程更新
学习目标
完成本课后,你将能够:
- 使用 git fetch 下载远程更新
- 说明 fetch 不会直接修改工作区
- 比较本地分支与远程跟踪分支
问题背景或应用场景
团队成员推送新提交后,本地仓库并不会自动获知。git fetch 用于安全地下载远程变化并更新远程跟踪引用,但不会直接改动当前分支和工作区。这种“先获取、再检查、后整合”的模式适合需要审查变化或避免意外合并的场景。
核心原理
获取操作分为两部分:下载本地缺少的对象,以及更新 origin/main 等远程跟踪引用。当前本地 main 指针不会移动,因此工作区内容保持不变。此时可以使用 git log main..origin/main 查看远程新增提交,或使用 git diff main..origin/main 查看差异。
fetch 的安全性来自它不会自动整合历史,但远程跟踪引用会更新。如果需要保留获取前的位置,应在操作前记录引用或创建临时分支。远程删除的分支默认可能仍残留在本地,可通过 git fetch --prune 清理失效引用。

基础用法
执行 git fetch origin 后,先查看 git status -sb 和 git log --oneline main..origin/main。确认变化符合预期,再选择 git merge origin/main、git rebase origin/main 或暂不整合。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。
bash
rm -rf git-fetch-demo
mkdir git-fetch-demo
cd git-fetch-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 fetch -q origin
printf "working-file: "
cat workspace/app.conf
printf "remote-new-commit: "
git -C workspace log -1 --format=%s origin/main
printf "local-commit: "
git -C workspace log -1 --format=%s main预期输出
text
working-file: version=1
remote-new-commit: feat: version 2
local-commit: feat: version 1Tips
- 在执行合并或变基前先
fetch,可以把“下载”和“整合”分开排查。 - 使用
git log --left-right main...origin/main查看双方独有提交。 - 定期使用
git fetch --prune清理已被远程删除的分支引用。
常见错误
1. 认为 fetch 会更新文件
- 错误表现:获取后打开文件仍是旧内容,误以为命令失败。
- 产生原因:
fetch只更新对象和远程跟踪引用。 - 正确处理:比较
main与origin/main,再决定如何整合。 - 修复结果:能够看到远程新提交,同时保持工作区不变。
2. 直接比较服务器实时状态
- 错误表现:未获取就判断本地与远程一致。
- 产生原因:
origin/main只是上次获取的快照。 - 正确处理:先执行
git fetch origin再比较。 - 修复结果:比较结果基于最新获取到的远程状态。
本课练习
1. 查看远程独有提交
- 任务目标:练习提交范围表达式。
- 输入或初始条件:远程比分支多两个提交。
- 实现要求:获取后列出
main..origin/main。 - 验收条件:只显示远程新增的两个提交。
2. 检查文件差异
- 任务目标:在整合前审查内容。
- 输入或初始条件:远程修改了一个配置文件。
- 实现要求:使用
git diff main..origin/main -- <文件>。 - 验收条件:能看到准确的配置差异。
3. 清理远程删除分支
- 任务目标:掌握 prune。
- 输入或初始条件:远程删除一个测试分支。
- 实现要求:获取并清理失效远程跟踪引用。
- 验收条件:本地不再显示对应
origin/<分支>。
按自己的节奏,确认真正理解。