git push命令
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