status¶
简介¶
显示工作副本中所有文件修改状态。
vb status [OPTIONS] [PATH...]
示例¶
status 与 changes 命令信息显示差异：
$ vb status
repository: C:/Users/Administrator/Desktop/jenkins_home/workspace/VisionByte/Document/projectz/source/test/status/status_project.vbyte
local-root: C:/Users/Administrator/Desktop/jenkins_home/workspace/VisionByte/Document/projectz/source/test/status/status_project/
config-db: C:\Users\Administrator\AppData\Local//SOFTBRIDGE//__vbglobal__
checkout: b4a0e3c8d5e69bcad57cf4b355527192fec10aa4 2024-09-02 03:12:13 UTC
parent: 8aa0b7b6467217cf1a0a9f6fb04f9b7aa904b8ca 2024-07-23 07:13:26 UTC
tags: trunk
comment: 文件修改 (user: admin)
MISSING test1.txt
MISSING test2.txt
EDITED test3.txt
只显示未版本化文件：
$ vb status --extra
repository: C:/Users/Administrator/Desktop/jenkins_home/workspace/VisionByte/Document/projectz/source/test/status/status_project.vbyte
local-root: C:/Users/Administrator/Desktop/jenkins_home/workspace/VisionByte/Document/projectz/source/test/status/status_project/
config-db: C:\Users\Administrator\AppData\Local//SOFTBRIDGE//__vbglobal__
checkout: b4a0e3c8d5e69bcad57cf4b355527192fec10aa4 2024-09-02 03:12:13 UTC
parent: 8aa0b7b6467217cf1a0a9f6fb04f9b7aa904b8ca 2024-07-23 07:13:26 UTC
tags: trunk
comment: 文件修改 (user: admin)
EXTRA main.c
EXTRA README.md
忽略未版本控制的
*.md文件：
$ vb status --ignore "*.md"
repository: C:/Users/Administrator/Desktop/jenkins_home/workspace/VisionByte/Document/projectz/source/test/status/status_project.vbyte
local-root: C:/Users/Administrator/Desktop/jenkins_home/workspace/VisionByte/Document/projectz/source/test/status/status_project/
config-db: C:\Users\Administrator\AppData\Local//SOFTBRIDGE//__vbglobal__
checkout: b4a0e3c8d5e69bcad57cf4b355527192fec10aa4 2024-09-02 03:12:13 UTC
parent: 8aa0b7b6467217cf1a0a9f6fb04f9b7aa904b8ca 2024-07-23 07:13:26 UTC
tags: trunk
comment: 文件修改 (user: admin)
MISSING test1.txt
MISSING test2.txt
EDITED test3.txt
使新增文件版本化：
$ vb addremove
ADDED main.c
ADDED README.md
DELETED test1.txt
DELETED test2.txt
added 2 files, deleted 2 files
说明¶
文件修改状态：
EDITED 表示文件被修改； MISSING 表示文件被删除， ADDED 表示新增版本化文件；CONFLICT 表示发生冲突文件， EXTRA 表示未版本控制的文件。
如果指定了路径，则只显示指定路径下的文件修改状态。文件夹则会进行递归显示。
默认显示所有修改类型的文件集，也可通过一个或多个过滤选项(见下文)来显示特定修改类型的文件。
作为一种特殊情况，--no-merge 选项不会禁止此默认值。
默认显示的文件集也表示 commit 命令即将提交的内容。
status命令与 changes 命令基本相同，但是会额外显示工程信息，并且始终显示文件修改类型。
该命令默认情况下会显示未版本化文件，可以通过 display-extra 进行本地配置，或者使用 --no-extra 选项不显示当前未版本控制的文件。
有修改的文件名按行进行输出，路径显示方式由工程 relative-paths 设置决定，
也可通过 --abs-paths (绝对路径) 或者 --rel-paths (相对路径) 进行显示指定。默认以相对路径进行显示。
备注
绝对路径是指相对于签出工程根目录的路径，而不是文件系统的绝对路径。
如果未指定过滤选项或者指定了 --merge 选项，则每个合并贡献者签入版本的工件哈希将显示在报告末尾。
--no-merge 选项对于在没有合并贡献者的情况下显示默认的更改文件集很有用。
如果启用更改类型分类，则每个输出行都以描述文件更改类型的代码开头，如 EDITED 或 RENAMED 。
除非恰好选择了一种更改类型，否则默认情况下启用它。
为了确定默认值，--changed 算作选择一种更改类型。
默认值可以通过 --classify 或 --no-classify 选项覆盖。
--edited 和 --updated 产生不相交的集合。
--updated 仅当文件与其合并贡献者的文件相同且更改类型分类为 UPDATED_BY_MERGE 或 UPDATED_BY_INTEGRATE 时才显示该文件。
如果文件必须与任何其他更改合并，则它被视为合并或冲突，因此将通过 –edited 而不是 –updated 显示，类型为 EDITED 或 CONFLICT 。
--changed 选项可用于显示 --edited 和 --updated 的并集。
--differ 如此命名是因为它列出了签出版本和签出目录之间的所有差异。
除了默认更改（不包括 --merge ）之外，它还列出了可能值得添加的额外文件（如果忽略 glob 设置正确）。
在进行提交之前，最好检查 --differ 以查看将提交哪些更改以及是否需要添加任何文件。
如果同时指定 --merge 和 --no-merge ，则 --no-merge 优先，
--classify 和 --no-classify 也是如此。
命令 vb changes --extra 等同于 vb extras 。
选项¶
|
显示文件名绝对路径 （相对于工程根目录的路径) |
|
显示文件名相对路径 (默认) |
|
使用文件哈希而不是修改时间确认修改状态 |
|
是否覆盖工程大小写敏感设置 |
|
Include unmanaged files beginning with a dot 包含.开头的不在版本控制系统文件 |
|
Ignore unmanaged files matching CSG glob patterns 忽略未在版本控制的文件 |
过滤选项
|
显示edited、merged和conflicted的文件 |
|
显示通过合并进行更新的文件 |
|
显示 –edited 和 –updated 的文件集合 |
|
显示缺失（missing）的文件 |
|
显示新增（added） 文件 |
|
显示删除（deleted）文件 |
|
显示重命名（renamed）文件 |
|
显示合并冲突的文件 |
|
显示元信息修改的文件 |
|
显示未修改的文件 |
|
全部显示，包含上面列出的所有选项 |
|
只显示不在版本控制系统的文件 |
|
显示修改和不在版本控制系统的文件 |
|
显示合并作者 |
|
不显示合并作者 |
|
不显示未版本控制的文件 |