主线 · 第 5 / 8 篇
· 约 8 分钟
本地和远程怎么对上:远程跟踪分支、fetch、pull 和 push
远程跟踪分支是上次联网时记下的书签,不联网就不会更新。fetch 只更新书签,pull 再把它并进当前分支,push 只接受快进。被拒绝的推送是在保护别人的提交,强制推送覆盖的正是这些提交。
和远程仓库打交道时,常见的疑问有这几个。同事明明推送了,为什么 git status 还说 up to date?git push 为什么被拒绝?fetch 和 pull 差在哪?强制推送到底危险在哪?这些都和一个容易忽略的事实有关:本地对远程的了解,停留在上一次联网的那一刻。
先说明几个词。远程仓库(remote)是另一个仓库的名字和地址,克隆时默认叫 origin。远程跟踪分支是 origin/main 这样的名字,记录远程仓库里分支的位置。上游(upstream)是本地分支对应的那个远程分支。
每个克隆都是完整的仓库
这一篇的演示换成两个人。用一个没有工作区的裸仓库扮演服务器,alice 和 bob 各有一个克隆。作者名换了,所以哈希和前几篇不同,内容还是 first、second 两次提交。
alice 先把 main 推上去,bob 再克隆。克隆完,bob 本地的 git log 里已经有这两个提交。普通网络克隆按远端公开的引用获取可达历史,并建立本地引用;不能指望重新克隆就找回远端已经不可达的提交。之后的同步,无论 fetch 还是 push,做的都是两件事:补齐相关历史缺少的对象,再更新引用。第一篇说的对象和引用,跨仓库时仍然适用。
远程跟踪分支是一张书签
bob 的仓库里有哪些分支:
$ git branch -a
* main
remotes/origin/HEAD -> origin/main
remotes/origin/main
origin/HEAD 只记着远程的默认分支是哪个,可以先不管。main 是 bob 自己的分支,origin/main 是远程跟踪分支。Pro Git 的说法是:远程跟踪分支是远程分支状态的引用,是本地无法自行改动的引用,联网通信时由 Git 更新;可以把它看作书签,记着上一次连接时远程分支在哪里。
“无法自行改动”在演示里能看出来。git switch origin/main 会被拒绝,提示 a branch is expected, got remote branch 'origin/main',只能加 --detach 以游离 HEAD 的方式去看。它不是用来在上面提交的分支。
本地 main 的上游就是 origin/main。git branch -vv 会把它写在方括号里:* main 47cd3f1 [origin/main] second。alice 推送时用的 git push -u,输出里那句 branch 'main' set up to track 'origin/main' 就是在设置上游。这里的 track 指设置上游,和第二篇的“已跟踪文件”不是一回事。
fetch 只更新书签
alice 又提交一次并推送。这时 bob 的状态:
$ git status
Your branch is up to date with 'origin/main'.
这是最常见的误解。up to date 是和本地的 origin/main 比,而 origin/main 还停在 bob 上次联网的位置,Git 并没有去问服务器。执行 git fetch 之后:
$ git fetch
From ../origin
47cd3f1..ddac9bb main -> origin/main
$ git status
Your branch is behind 'origin/main' by 1 commit, and can be fast-forwarded.
fetch 把 alice 的新提交下载下来,把 origin/main 改成指向 ddac9bb。bob 的 main 没动,工作区里也还没有 alice 新加的 alice.txt。Pro Git 也特别提醒:fetch 只会把数据下载到本地仓库,不会自动合并或修改当前的工作。git branch -vv 这时显示 [origin/main: behind 1],领先和落后的数字同样是和书签比出来的。
pull 多走一步。按 git-pull 文档,它先用同样的参数执行 fetch,再把上游分支整合进当前分支。这次 bob 的 main 能顺着走到 origin/main,git pull 就是一次快进。
| 命令 | 改了什么 |
|---|---|
git fetch | 下载对象,更新远程跟踪分支 |
git pull | 先 fetch,再把上游整合进当前分支 |
git push | 上传对象,让远程的分支指向本地的提交,默认只接受快进 |
push 为什么会被拒绝
接下来 alice 又推送了一次,bob 没有 fetch,直接在自己的 main 上提交,然后推送:
$ git push
To ../origin.git
! [rejected] main -> main (fetch first)
error: failed to push some refs to '../origin.git'
hint: Updates were rejected because the remote contains work that you do not
hint: have locally. This is usually caused by another repository pushing to
hint: the same ref. If you want to integrate the remote changes, use
hint: 'git pull' before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.
git-push 文档里有一节专门讲快进:一个引用从提交 A 改成指向 B,只有 B 是 A 的后代(从 B 顺着父提交能走到 A)才算快进,快进不会丢失历史;非快进会。服务器上的 main 已经指向 alice 的新提交,bob 的提交不是它的后代。如果接受这次推送,所有人都会从 bob 的提交继续往下做,alice 那个提交就从 main 上掉了出去。所以默认拒绝。
被拒绝不是出错,是在保护别人的提交。文档给的做法是先把远程的历史取回来,做出一份包含双方改动的历史,再推送。fetch 之后,bob 的状态变成:
Your branch and 'origin/main' have diverged,
and have 1 and 1 different commits each, respectively.
这时直接 git pull,Git 会停下来,要求说明是合并还是变基:fatal: Need to specify how to reconcile divergent branches。git-pull 文档的说法是,默认只做快进,本地分支和远程分叉时就失败;--no-rebase 走合并,--rebase 走变基,也可以用 pull.rebase 等配置固定下来。
bob 用 git pull --no-rebase 得到一个合并提交。它有两个父提交,一个是 alice 的提交,一个是 bob 的提交。远程 main 指向的正是 alice 的那个提交,合并提交是它的后代,所以再推送时,远程的 main 从 alice 的提交走到 bob 的合并提交,是快进,推送成功。
强制推送覆盖的是什么
git push --force 让远程接受非快进的更新。演示里,alice 再推送一次 6eadf5c,bob 没 fetch,改了自己的文件后强制推送:
$ git push --force
To ../origin.git
+ 6eadf5c...811f04a main -> main (forced update)
远程的 main 现在指向 bob 的提交。在服务器仓库里查,6eadf5c 这个对象还在,但已经没有任何分支包含它。alice 的那次提交,就这样从共享的历史里消失了。这和第三篇说的删分支一样:没删对象,删掉的是能找到它的那条路。
更稳妥的是 --force-with-lease。按 git-push 文档,不带参数时,它要求远程分支的当前值和本地的远程跟踪分支一致才更新,相当于给覆盖加了一个前提:远程还停在上次看到的位置,才允许覆盖。其实演示里 bob 在强推之前先试过它:
$ git push --force-with-lease
To ../origin.git
! [rejected] main -> main (stale info)
error: failed to push some refs to '../origin.git'
bob 的书签还停在旧位置,和服务器对不上,这次推送被拒绝,alice 的提交本来已经保住了,是随后的 --force 绕过了这层检查。反过来也能推出它的局限:如果先 fetch 了,书签就和服务器一致,这层检查也就拦不住了。编辑器或工具在后台自动 fetch,也会造成同样的结果,第八篇的 --force-if-includes 补的就是这一点。所以 fetch 之后要先看清远程多了哪些提交,再决定要不要覆盖。
oh-my-git 讲远程的两关也是这个场景:一关是和朋友轮流往同一篇文章里加句子,一关是两个人同时改了同一个文件,得先同步再说。
审 AI 的 Git 操作时,推送前先确认它在比对谁:git status 说 up to date 之前有没有 fetch。看清输出里推的是哪个本地分支到哪个远程分支,比如 main -> main。遇到 rejected,正确的下一步是取回来整合,不是直接加 --force;输出里出现 forced update,就要问清楚覆盖掉了谁的提交。
参考资料
- Pro Git:远程仓库的使用:fetch 只下载数据、不合并,别人先推送时自己的推送会被拒绝。
- Pro Git:远程分支:远程跟踪分支是书签,跟踪分支与上游,
git branch -vv的领先和落后。 - git-pull:先 fetch 再整合,默认只快进,
--rebase与--no-rebase。 - git-push:NOTE ABOUT FAST-FORWARDS 一节,
--force-with-lease的检查条件。 - oh-my-git:remotes 一组关卡,轮流推送和同时修改。
本文涉及的知识点
9 个
名称打开知识图谱中的对应条目;「另见」只计已发布文章。
本节知识点
本节知识点