branch

简介

分支管理。

vb branch SUBCOMMAND ... [OPTIONS]

示例

• 创建一个名为 v2.0 的新分支：

$ vb branch new v2.0 trunk
New branch: 8db2e9d0ec05fc5d0efdf578432660fb1a72ac0f686398323d491f624074d4a9

• 打印当前签出分支名：

$ vb branch current
trunk

• 打印 v2.0 分支信息 ：

$ vb branch info v2.0
v2.0: open as of 2024-11-25 20:15:44 on 8db2e9d0ec05fc5d

• 创建一个名为 private1.0 的私人分支：

$ vb branch new private1.0 trunk --private
New branch: 289a31bf843541bf7712af43efeb2d14c54e712b33df39377613cdeb3accda1e

• 列出当前所有分支：

$ vb branch ls -a
#  private1.0
 * trunk
   v2.0

说明

运行各种子命令来管理打开的仓库或用 -R|--repository 选项打开或管理指定仓库的分支。

选项

-R|--repository REPO

在指定仓库上运行该命令

子命令

new

vb branch new BRANCH-NAME BASIS [OPTIONS]

我们通常在开发新功能、修复一个紧急 bug 等会选择创建分支。该命令在指定的签入版本 BASIS 下创建一个名为 BRANCH-NAME 的新分支 。

选项

--private	新建分支是私有的（即仍为本地）
--bgcolor COLOR	使用指定颜色代替自动颜色背景
--nosign	请勿在此分支上签名内容
--date-override DATE	使用指定时间 DATE 代替现在时间
--user-override USER	使用指定用户 USER 用来替代当前默认用户

current

vb branch current

打印当前签出的分支名称。

info

vb branch info BRANCH-NAME

显示出指定分支的信息。

list|ls|lsh

vb branch list|ls [OPTIONS] [GLOB]

vb branch lsh [OPTIONS] [LIMIT]

列出所有分支。

如果给出了匹配模式 ，则仅显示与模式匹配的分支。

此子命令的 lsh 变体显示最近更改的分支，并接受可选的 LIMIT 参数（默认为 5）来限制输出，

但不接受匹配模式参数。支持所有其他选项，但 -t 是隐含的无操作。

选项

-a|--all	列出所有分支。默认仅显示开放的分支
-c|--closed	列出所用关闭的分支
-m|--merged	列出合并到当前分支的分支
-M|--unmerged	列出未合并到当前分支的分支
-p	仅列出私有分支
-r	反转分支排列顺序
-t	首先显示最近更改的分支
-self	仅列出您参与的分支
-username USER	仅列出选定用户 USER 参与的分支
-users N	列出最多 N 名参与的用户

备注

当前分支以星号 * 标记。私有分支以井号 # 标记。

close|reopen

vb branch close|reopen [OPTIONS] BRANCH-NAME [BRANCH-NAME...]

为此分支添加一个 closed 标签，目的是关闭此分支，此分支名能接受有符号。

为一个或多个分支添加或取消 closed 标签。它接受与 close 子命令相同的选项。

选项

-n|--dry-run	试运行，不执行任何操作，但显示将发生的情况。
-v|--verbose	输出更多详细信息
--date-override DATE	使用指定时间 DATE 代替现在时间
--user-override USER	使用指定用户 USER 用来替代当前默认用户

hide|unhide

vb branch hide|unhide [OPTIONS] BRANCH-NAME [BRANCH-NAME...]

添加或取消指定分支或签入 ID 的 hidden 标签。接受与 close 子命令相同的选项。