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

获取远程更新

获取远程更新

学习目标

完成本课后,你将能够:

  • 使用 git fetch 下载远程更新
  • 说明 fetch 不会直接修改工作区
  • 比较本地分支与远程跟踪分支

问题背景或应用场景

团队成员推送新提交后,本地仓库并不会自动获知。git fetch 用于安全地下载远程变化并更新远程跟踪引用,但不会直接改动当前分支和工作区。这种“先获取、再检查、后整合”的模式适合需要审查变化或避免意外合并的场景。

核心原理

获取操作分为两部分:下载本地缺少的对象,以及更新 origin/main 等远程跟踪引用。当前本地 main 指针不会移动,因此工作区内容保持不变。此时可以使用 git log main..origin/main 查看远程新增提交,或使用 git diff main..origin/main 查看差异。

fetch 的安全性来自它不会自动整合历史,但远程跟踪引用会更新。如果需要保留获取前的位置,应在操作前记录引用或创建临时分支。远程删除的分支默认可能仍残留在本地,可通过 git fetch --prune 清理失效引用。

fetch 不修改工作区示意图

基础用法

执行 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 1

Tips

  • 在执行合并或变基前先 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/<分支>。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

获取远程更新

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

登录哪都通