git branch, 显示、创建或者删除分支。
语法
1 2 3 4 5 6 7 8 9 10 11 12 13 | git branch [--color[=<when>] | --no-color] [-r | -a] [--list] [-v [--abbrev=<length> | --no-abbrev]] [--column[=<options>] | --no-column] [--sort=<key>] [(--merged | --no-merged) [<commit>]] [--contains [<commit]] [--no-contains [<commit>]] [--points-at <object>] [--format=<format>] [<pattern>…] git branch [--track | --no-track] [-l] [-f] <branchname> [<start-point>] git branch (--set-upstream-to=<upstream> | -u <upstream>) [<branchname>] git branch --unset-upstream [<branchname>] git branch (-m | -M) [<oldbranch>] <newbranch> git branch (-c | -C) [<oldbranch>] <newbranch> git branch (-d | -D) [-r] <branchname>… git branch --edit-description [<branchname>] |
描述
如果给出--list,或者没有任何选项,将列出本地分支。-r选项列出远程分支。-a选项列出本地和远程分支。可以使用<pattern>来只显示匹配的branch,给出<pattern>后,必须使用--list选项,否则将被翻译位创建分支。可以使用多个<pattern>,只要任何一个匹配都将被显示。
第二种形式用来创建一个新的分支,指向HEAD或者给定的<start-point>。只是创建分支,但是不会更新工作区,需要使用checkout来切换工作区。
-m选项用来重命名分支。
-c选项用来重命名分支,同时旧分支的配置和reflog也被拷贝到新分支。
-d选项用来删除分支。可以同时删除多个分支,如果分支有reflog,reflog也将被删除。
-r和-d选项一起使用,用来删除远程分支。注意:这只是用来删除远端仓库不存在的分支。只是本地删除动作。
选项:
-r
--remotes
列出或者删除(与-d一起使用)remote-tracking branches。
-t
--track
当创建一个新的分支时,设置branch.<name>.remote 和 branch.<name>.merge配置选项,来标记<start-point>为upstream branch。
-u <upstream>
--set-upstream-to=<upstream>
设置upstream branch,如果<upstrem>没有指定,则默认位当前分支。
<start-point>
新分支的head将指向这个commit,可以是分支名,可以是commit-id,tag。如果省略,当前HEAD将被使用。