git-branch 手册页

名称

git分支列表、创建或删除分支

总览概要

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>, 则将其用作 shell 通配符, 以将输出限制为匹配分支。如果给定了多个模式, 则会显示一个分支, 如果它与任何模式匹配。请注意, 在提供 <pattern> 时, 必须使用--list; 否则命令将被解释为分支创建。

包含, 仅显示包含命名提交的分支 (换言之, 其提示提交的分支是命名提交的子代),-不包含反转它。合并后, 只会列出合并到命名提交中的分支 (即从命名提交中可以访问其提示提交的分支)。如果没有合并, 则只会列出未合并到命名提交中的分支。如果缺少 <commit> 参数, 则默认为 HEAD (即当前分支的尖端)。

该命令的第二个窗体创建一个名为 <branchname> 的新分支头, 它指向当前头, 或者如果给定, 则为 <start-point>。

请注意, 这将创建新的分支, 但它不会将工作树切换到它。使用 "git checkout <newbranch>" 切换到新分支。

当本地分支从远程跟踪分支启动时, Git 设置分支 (特别是分支. <name>。远程和分支。<name>. 合并配置项), 以便 git 抽取将从远程跟踪分支适当地合并。此行为可以通过全局分支. autoSetupMerge 配置标志进行更改。可以使用-轨道和-无跟踪选项来重写该设置, 并在以后使用 git 分支 (设置为上游) 进行更改。

使用-m 或-m 选项, <oldbranch> 将重命名为 <newbranch>。如果 <oldbranch> 有相应的 reflog, 则将其重命名为 "匹配" <newbranch>, 并创建一个 reflog 项以记住分支重命名。如果存在 <newbranch>,-m 必须用于强制重命名发生。

-c 和-c 选项具有与-m 和-m 完全相同的语义, 除了与其配置的分支以及 reflog 将被复制到一个新名称之外。

使用-d 或-d 选项, <branchname> 将被删除。您可以指定多个分支以进行删除。如果分支当前有 reflog, 则 reflog 也将被删除。
 

使用-r 与-d 一起删除远程跟踪分支。请注意, 如果删除远程跟踪分支 (如果它们不再存在于远程存储库中), 或者如果 git 提取被配置为不再次获取它们, 则只会有意义。另请参阅 git 远程 (1) 的修剪子命令, 以清除所有过时的远程跟踪分支。