概述
git push
命令用于将本地分支的更新,推送到远程主机。它的格式与git pull
命令相仿。
git push和当前的HEAD指针位于哪里没关系,只要指定完整的格式,即使当前指针不在分支上,也可以推送到远程
git checkout c0
git push origin master
当要推送到的目的分支不存在时,Git 会在远程仓库中根据你提供的名称帮你创建这个分支!
git push origin main:newBranch
命令
git push完整格式
git push origin <source>:<destination>
git push <远程主机名> <本地分支名>:<远程分支名>
注意,分支推送顺序的写法是<来源地>:<目的地>,所以git pull
是<远程分支>:<本地分支>,而git push
是<本地分支>:<远程分支>。
source
可以是任何 Git 能识别的位置:
git push origin foo^:main
Git 将 foo^
解析为一个位置,上传所有未被包含到远程仓库里 main
分支中的提交记录。
如果省略远程分支名,则表示将本地分支推送与之存在"追踪关系"的远程分支(通常两者同名),如果该远程分支不存在,则会被新建。
git push origin master
上面命令表示,将本地的master
分支推送到origin
主机的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
了。
参数
--all
不带任何参数的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
主机。
--force
如果远程主机的版本比本地版本更新,推送时Git会报错,要求先在本地做git pull
合并差异,然后再推送到远程主机。这时,如果你一定要推送,可以使用--force
选项。
git push --force origin
上面命令使用--force
选项,结果导致远程主机上更新的版本被覆盖。除非你很确定要这样做,否则应该尽量避免使用--force
选项。
--tags
git push
不会推送标签(tag),除非使用--tags
选项。
git push origin --tags