git push
命令用於將本地分支的更新,推播到遠端主機。它的格式與git pull
命令相似。
$ git push <遠端主機名> <本地分支名>:<遠端分支名>
使用語法
git push [--all | --mirror | --tags] [--follow-tags] [--atomic] [-n | --dry-run] [--receive-pack=<git-receive-pack>]
[--repo=<repository>] [-f | --force] [-d | --delete] [--prune] [-v | --verbose]
[-u | --set-upstream] [--push-option=<string>]
[--[no-]signed|--sign=(true|false|if-asked)]
[--force-with-lease[=<refname>[:<expect>]]]
[--no-verify] [<repository> [<refspec>…]]
使用本地參照更新遠端參照,同時傳送完成給定參照所需的物件。可以在每次推入儲存庫時,通過在那裡設定掛鉤觸發一些事件。
當命令列不指定使用<repository>
引數推播的位置時,將查詢當前分支的branch.*.remote
組態以確定要在哪裡推播。 如果組態丟失,則預設為origin
。
以下是一些範例 -
$ git push origin master
上面命令表示,將原生的master
分支推播到origin
主機的master
分支。如果master
不存在,則會被新建。
如果省略本地分支名,則表示刪除指定的遠端分支,因為這等同於推播一個空的本地分支到遠端分支。
$ git push origin :master
# 等同於
$ git push origin --delete master
上面命令表示刪除origin
主機的master
分支。如果當前分支與遠端分支之間存在追蹤關係,則本地分支和遠端分支都可以省略。
$ git push origin
上面命令表示,將當前分支推播到origin
主機的對應分支。如果當前分支只有一個追蹤分支,那麼主機名都可以省略。
$ git push
如果當前分支與多個主機存在追蹤關係,則可以使用-u
選項指定一個預設主機,這樣後面就可以不加任何引數使用git push
。
$ git push -u origin master
上面命令將原生的master
分支推播到origin
主機,同時指定origin
為預設主機,後面就可以不加任何引數使用git push
了。
不帶任何引數的git push
,預設只推播當前分支,這叫做simple
方式。此外,還有一種matching
方式,會推播所有有對應的遠端分支的本地分支。Git 2.0版本之前,預設採用matching
方法,現在改為預設採用simple
方式。如果要修改這個設定,可以採用git config
命令。
$ git config --global push.default matching
# 或者
$ git config --global push.default simple
還有一種情況,就是不管是否存在對應的遠端分支,將原生的所有分支都推播到遠端主機,這時需要使用–all
選項。
$ git push --all origin
上面命令表示,將所有本地分支都推播到origin
主機。
如果遠端主機的版本比本地版本更新,推播時Git會報錯,要求先在本地做git pull
合併差異,然後再推播到遠端主機。這時,如果你一定要推播,可以使用–force
選項。
$ git push --force origin
上面命令使用-–force
選項,結果導致在遠端主機產生一個」非直進式」的合併(non-fast-forward merge)。除非你很確定要這樣做,否則應該盡量避免使用–-force
選項。
最後,git push
不會推播標籤(tag),除非使用–tags
選項。
$ git push origin --tags
將當前分支推播到遠端的同名的簡單方法,如下 -
$ git push origin HEAD
將當前分支推播到源儲存庫中的遠端參照匹配主機。 這種形式方便推播當前分支,而不考慮其本地名稱。如下 -
$ git push origin HEAD:master
其它範例
1.推播本地分支lbranch-1
到新大遠端分支rbranch-1
:
$ git push origin lbranch-1:refs/rbranch-1
2.推播lbranch-2
到已有的rbranch-1
,用於補充rbranch-1
:
$ git checkout lbranch-2
$ git rebase rbranch-1
$ git push origin lbranch-2:refs/rbranch-1
3.用本地分支lbranch-3
覆蓋遠端分支rbranch-1
:
$ git push -f origin lbranch-2:refs/rbranch-1
或者 -
$ git push origin :refs/rbranch-1 //刪除遠端的rbranch-1分支
$ git push origin lbranch-1:refs/rbranch-1
4.檢視push
的結果
$ gitk rbranch-1
5.推播tag
$ git push origin tag_name
6.刪除遠端標籤
$ git push origin :tag_name