git-branch - 列出，创建或删除分支
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] [-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>，则将其用作shell通配符以将输出限制为匹配的分支。如果给出了多个模式，则如果它与任何模式匹配，则显示分支。注意，提供<pattern>时，必须使用--list;否则该命令被解释为分支创建。
使用--contains，仅显示包含命名提交的分支（换句话说，提示提交是指定提交的后代的分支），--no-contains将其反转。使用--merged，将仅列出已合并到命名提交的分支（即，可以从命名提交到达提示提交的分支）。使用--no-merged将仅列出未合并到命名提交的分支。如果< commit>参数缺失它默认为HEAD（即当前分支的尖端）。
命令的第二个表单创建一个名为< branchname>的新分支头。它指向当前的HEAD，或者<起点>如果给予。
请注意，这将创建新分支，但不会将工作树切换到它;使用“git checkout< newbranch>”切换到新分支。
当远程跟踪分支启动本地分支时，Git设置分支（特别是branch.<name>.remote和branch.<name>.merge配置条目），以便 git pull 将从远程跟踪分支适当地合并。可以通过全局branch.autoSetupMerge配置标志更改此行为。可以使用--track和--no-track选项覆盖该设置，稍后使用git branch --set-upstream-to进行更改。
使用-m或-M选项，< oldbranch>将重命名为< newbranch>。如果< oldbranch>有一个相应的reflog，它被重命名为匹配< newbranch>，并创建一个reflog条目来记住分支重命名。如果< newbranch>存在，-M必须用于强制重命名发生。
-c和-C选项具有与-m和-M完全相同的语义，除了将分支与其配置重命名，并且reflog将被复制到新名称。
使用-d或-D选项，<branchname>将被删除。您可以指定多个分支进行删除。如果分支当前有reflog，那么reflog也将被删除。
将-r与-d一起使用以删除远程跟踪分支。请注意，如果远程存储库中不再存在远程跟踪分支，或者如果 git fetch 配置为不再获取它们，则删除它们才有意义。另请参阅 git-remote [1] 的 prune 子命令，了解清除所有过时的远程跟踪分支的方法。
-d
--delete
删除分支。分支必须在其上游分支中完全合并，或者如果没有使用--track或--set-upstream-to设置上游，则必须在HEAD中合并。
-D
--delete --force的快捷方式。
--create-reflog
创建分支的reflog。这将激活对分支引用所做的所有更改的记录，从而可以使用基于日期的sha1表达式，例如“< branchname> @ {yesterday}”。请注意，在非裸存储库中，默认情况下，core.logAllRefUpdates配置选项通常会启用reflog。否定形式--no-create-reflog仅覆盖较早的--create-reflog，但目前不会否定core.logAllRefUpdates的设置。
-f
--force
重置< branchname>到< startpoint>，即使< branchname>已存在。没有-f， git branch 拒绝更改现有分支。与-d（或--delete）结合使用，允许删除分支，而不管其合并状态如何。与-m（或--move）结合使用，即使新分支名称已存在，也允许重命名分支，这同样适用于-c（或--copy）。
-m
--move
移动/重命名分支和相应的reflog。
-M
--move --force的快捷方式。
-c
--copy
复制分支和相应的reflog。
-C
--copy --force的快捷方式。
--color[=<when>]
颜色分支以突出显示当前，本地和远程跟踪分支。该值必须始终为（默认值），never或auto。
--no-color
即使配置文件提供默认的颜色输出，也要关闭分支颜色。与--color=never相同。
-i
--ignore-case
排序和过滤分支不区分大小写。
--column[=<options>]
--no-column
在列中显示分支列表。有关选项语法，请参阅配置变量column.branch。没有选项的--column和--no-column分别相当于和_永远不会_。
此选项仅适用于非详细模式。
-r
--remotes
列出或删除（如果与-d一起使用）远程跟踪分支。
-a
--all
列出远程跟踪分支和本地分支。
-l
--list
列出分支。使用可选的<pattern>...，例如git branch --list 'maint-*'，仅列出与模式匹配的分支。
-v
-vv
--verbose
在列表模式下，显示每个头的sha1和提交主题行，以及与上游分支（如果有）的关系。如果给出两次，也打印上游分支的名称（另请参见git remote show <remote>）。
-q
--quiet
在创建或删除分支时更安静，禁止出现非错误消息。
--abbrev=<length>
在输出列表中更改sha1的最小显示长度。默认值为7，可以通过core.abbrev配置选项覆盖。
--no-abbrev
在输出列表中显示完整的sha1，而不是缩写它们。
-t
--track
创建新分支时，设置branch.<name>.remote和branch.<name>.merge配置条目以将起点分支标记为新分支的“上游”。此配置将告诉git显示git status和git branch -v中两个分支之间的关系。此外，它在没有参数的情况下指示git pull在检出新分支时从上游拉出。
当起点是远程跟踪分支时，此行为是默认行为。如果希望git checkout和git branch始终表现得像--no-track一样，请将branch.autoSetupMerge配置变量设置为false。如果在起点是本地或远程跟踪分支时需要此行为，请将其设置为always。
--no-track
即使branch.autoSetupMerge配置变量为true，也不要设置“上游”配置。
--set-upstream
由于此选项具有令人困惑的语法，因此不再支持它。请改用--track或--set-upstream-to。
-u <upstream>
--set-upstream-to=<upstream>
设置< branchname>的跟踪信息，以便< upstream>被认为是< branchname>的上游分支。如果没有< branchname>如果已指定，则默认为当前分支。
--unset-upstream
删除< branchname>的上游信息。如果未指定分支，则默认为当前分支。
--edit-description
打开编辑器并编辑文本以解释分支的用途，供各种其他命令使用（例如format-patch，request-pull和merge（如果已启用））。可以使用多行解释。
--contains [<commit>]
仅列出包含指定提交的分支（如果未指定，则为HEAD）。意味着--list。
--no-contains [<commit>]
仅列出不包含指定提交的分支（如果未指定，则为HEAD）。意味着--list。
--merged [<commit>]
仅列出其提示可从指定提交到达的分支（如果未指定，则为HEAD）。意味着--list，与--no-merged不兼容。
--no-merged [<commit>]
仅列出其提示无法从指定的提交访问的分支（如果未指定，则为HEAD）。意味着--list，与--merged不兼容。
<branchname>
要创建或删除的分支的名称。新分支名称必须通过 git-check-ref-format [1] 定义的所有检查。其中一些检查可能会限制分支名称中允许的字符。
<start-point>
新的分支头将指向此提交。它可以作为分支名称，commit-id或标记给出。如果省略此选项，则将使用当前HEAD。
<oldbranch>
要重命名的现有分支的名称。
<newbranch>
现有分支的新名称。与< branchname>相同的限制应用。
--sort=<key>
根据给定的密钥排序。前缀-按值的降序排序。您可以使用--sort =< key>选项多次，在这种情况下，最后一个键成为主键。支持的键与git for-each-ref中的键相同。排序顺序默认为branch.sort变量（如果存在）配置的值，或基于完整refname（包括refs/...前缀）的排序。这首先列出分离的HEAD（如果存在），然后是本地分支，最后是远程跟踪分支。见 git-config [1] 。
--points-at <object>
仅列出给定对象的分支。
--format <format>
从显示的分支ref和它指向的对象插入%(fieldname)的字符串。格式与 git-for-each-ref [1] 的格式相同。
仅在列出分支时，即使用或暗示--list时，才会遵守pager.branch。默认是使用寻呼机。见 git-config [1] 。
Start development from a known tag
$ git clone git://git.kernel.org/pub/scm/.../linux-2.6 my2.6
$ cd my2.6
$ git branch my2.6.14 v2.6.14 (1)
$ git checkout my2.6.14
- 这一步和下一步可以通过“checkout -b my2.6.14 v2.6.14”组合成一个步骤。
Delete an unneeded branch
$ git clone git://git.kernel.org/.../git.git my.git
$ cd my.git
$ git branch -d -r origin/todo origin/html origin/man (1)
$ git branch -D test (2)
-
删除远程跟踪分支“todo”，“html”和“man”。下一个_获取_或_拉_将再次创建它们，除非你不配置它们。参见 git-fetch [1] 。
-
即使“master”分支（或当前检出的任何分支）没有来自测试分支的所有提交，也要删除“test”分支。
如果要创建要立即签出的分支，则可以更轻松地使用git checkout命令及其-b选项来创建分支并使用单个命令将其签出。
选项--contains，--no-contains，--merged和--no-merged有四个相关但不同的用途：
-
如果< commit>，则
--contains <commit>用于查找需要特别注意的所有分支。由于这些分支包含指定的< commit>，因此需要重新定义或修改。 -
--no-contains <commit>与此相反，即不包含指定的< commit>的分支。 -
--merged用于查找可以安全删除的所有分支，因为这些分支完全由HEAD包含。 -
--no-merged用于查找合并为HEAD的候选分支，因为这些分支未被HEAD完全包含。
git-check-ref-format [1] ， git-fetch [1] ， git-remote [1] ，“了解历史：什么是分支？“在Git用户手册中。
部分 git [1] 套件