非常教程

Git参考手册

Git

git ls-tree

名称

git-ls-tree - 列出树对象的内容

概要

git ls-tree [-d] [-r] [-t] [-l] [-z]
            [--name-only] [--name-status] [--full-name] [--full-tree] [--abbrev[=<n>]]
            <tree-ish> [<path>…​]

描述

列出给定树对象的内容,例如“/ bin / ls -a”在当前工作目录中所做的内容。注意:

  • 该行为与“/ bin / ls”的行为稍有不同,因为它<path>仅表示要匹配的模式列表,例如,指定目录名称(不含-r)将具有不同的行为,并且参数的顺序无关紧要。
  • 该行为与“/ bin / ls”的行为相似,<path>因为相对于当前工作目录而言。例如,当你在一个sub具有目录的目录中时dir,你可以运行git ls-tree -r HEAD dir以列出树的内容(即sub/dirHEAD)。你不想给一棵树,是不是在根级别(例如,git ls-tree -r HEAD:sub dir在这种情况下),因为这将导致要求sub/sub/dirHEAD承诺。但是,通过传递--full-tree 选项可以忽略当前工作目录。

选项

<tree-ish>

Id of a tree-ish.

-d

仅显示已命名的树条目本身,而不是其子节点。

-r

递归到子树中。

-t

甚至在进行递归时也显示树条目。如果-r未通过,则无效。-d意味着-t

-l --long

显示 blob(文件)条目的对象大小。

-z

\ 0 行输出终止,不要引用文件名。有关更多信息,请参阅下面的 OUTPUT FORMAT。

--name-only --name-status

仅列出文件名(而不是“长”输出),每行一个。

--abbrev=<n>

不显示完整的40字节十六进制对象行,只显示部分前缀。非默认位数可以用--abbrev = <n> 来指定。

--full-name

显示相对于当前工作目录的路径名称,而不是显示完整的路径名称。

--full-tree

不要将列表限制到当前工作目录。意味着 --full-name。

<path>…​

当给出路径时,显示它们(请注意,这不是真正的原始路径名,而是一组匹配的模式列表)。否则,隐式使用树的根级作为唯一的路径参数。

输出格式

<mode> SP <type> SP <object> TAB <file>

这种输出格式是什么兼容--index-info --stdingit update-index期望。

当使用该-l选项时,格式更改为

<mode> SP <type> SP <object> SP <object size> TAB <file>

由<object>标识的对象大小以字节为单位,右对齐,最小宽度为7个字符。对象大小仅适用于 blob(文件)条目; 对于其他条目,-字符用于代替大小。

如果没有这个-z选项,带有“不寻常”字符的路径名将按照配置变量的说明引用core.quotePath(请参阅 git-config [1])。使用-z文件名是逐字输出的,并且该行由 NUL 字节终止。

Git

Git 是一个分布式版本控制软件,最初由林纳斯·托瓦兹(Linus Torvalds)创作,于2005年以 GPL 发布。最初目的是为更好地管理 Linux 内核开发而设计。

主页 https://git-scm.com/
源码 https://github.com/git/git
发布版本 2.14.3