git fetch 命令

git fetch命令用於從另外一個存儲庫下載對象和引用。

使用語法

git fetch [<options>] [<repository> [<refspec>…]]
git fetch [<options>] <group>
git fetch --multiple [<options>] [(<repository> | <group>)…]
git fetch --all [<options>]

Shell

描述

從一個或多個其餘存儲庫中獲取分支和/或標籤(統稱爲「引用」)以及完成其歷史所必需的對象。 遠程跟蹤分支已更新(Git術語叫作commit)，須要將這些更新取回本地，這時就要用到git fetch命令。

默認狀況下，還會獲取指向正在獲取的歷史記錄的任何標籤; 效果是獲取指向您感興趣的分支的標籤。可使用--tags或--no-tags選項或經過配置遠程.<name>.tagOpt 來更改此默認行爲。 經過使用顯式提取標籤的refspec，能夠獲取不指向您感興趣的分支的標籤。

git fetch能夠從單個命名的存儲庫或URL中獲取，也能夠從多個存儲庫中獲取，若是給定了<group>，而且配置文件中有一個遠程<group>條目。

獲取的參考名稱以及它們所指向的對象名稱被寫入到.git/FETCH_HEAD中。 此信息可能由腳本或其餘git命令使用，如git-pull。

示例

如下是一些示例 -

1.更新遠程跟蹤分支

$ git fetch origin

Shell

上述命令從遠程refs/heads/命名空間複製全部分支，並將它們存儲到本地的refs/remotes/ origin/命名空間中，除非使用分支.<name>.fetch選項來指定非默認的refspec。

2.明確使用refspec

$ git fetch origin +pu:pu maint:tmp

Shell

此更新(或根據須要建立)經過從遠程存儲庫的分支(分別)pu和maint提取來分支本地存儲庫中的pu和tmp。

即便沒有快進，pu分支將被更新，由於它的前綴是加號; tmp不會。

3.在遠程分支上窺視，無需在本地存儲庫中配置遠程

$ git fetch git://git.kernel.org/pub/scm/git/git.git maint
$ git log FETCH_HEAD

Shell

第一個命令從 git://git.kernel.org/pub/scm/git/git.git 從存儲庫中獲取maint分支，第二個命令使用FETCH_HEAD來檢查具備git-log的分支。

4.將某個遠程主機的更新

$ git fetch <遠程主機名>

Shell

要更新全部分支，命令能夠簡寫爲：

$ git fetch

Shell

上面命令將某個遠程主機的更新，所有取回本地。默認狀況下，git fetch取回全部分支的更新。若是隻想取回特定分支的更新，能夠指定分支名,以下所示 -

$ git fetch <遠程主機名> <分支名>

Shell

好比，取回origin主機的master分支。

$ git fetch origin master

Shell

所取回的更新，在本地主機上要用」遠程主機名/分支名」的形式讀取。好比origin主機的master分支，就能夠用origin/master讀取。

git branch命令的-r選項，能夠用來查看遠程分支，-a選項查看全部分支。

$ git branch -r
origin/master

$ git branch -a
* master
  remotes/origin/master

Shell

上面命令表示，本地主機的當前分支是master，遠程分支是origin/master。

取回遠程主機的更新之後，能夠在它的基礎上，使用git checkout命令建立一個新的分支。

$ git checkout -b newBrach origin/master

上面命令表示，在origin/master的基礎上，建立一個新分支:newBrach。

此外，也可使用git merge命令或者git rebase命令，在本地分支上合併遠程分支。

$ git merge origin/master
# 或者
$ git rebase origin/master

Shell

上面命令表示在當前分支上，合併origin/master。