git-ls-files

    git-ls-files - 显示索引和工作树中的文件信息

    概要

    这将目录高速缓存索引中的文件列表与实际工作目录列表合并，并显示两者的不同组合。

    以下一个或多个选项可用于确定显示的文件：

    OPTIONS

    1.  --cached

    在输出中显示缓存的文件（默认）

    1.  -d
    1.  --deleted

    在输出中显示已删除的文件

    1.  -m
    1.  --modified

    在输出中显示已修改的文件

    1.  -o
    1.  --others

    在输出中显示其他（即未跟踪）文件

    1.  -i

      仅显示输出中的忽略文件。在索引中显示文件时，仅打印与排除模式匹配的文件。显示“其他”文件时，仅显示与排除模式匹配的文件。标准忽略规则不会自动激活，因此至少需要一个--exclude*选项。

      1.  -s
      1.  --stage

      在输出中显示暂存内容的模式位，对象名称和阶段编号。

      1.  --directory

      如果整个目录被归类为“其他”，则只显示其名称（带斜杠）而不是其全部内容。

      1.  --no-empty-directory

      不要列出空目录。没有—directory没有效果。

      1.  --unmerged

      在输出中显示未合并的文件（强制 - 阶段）

      1.  -k
      1.  --killed

      显示文件系统上由于文件/目录冲突而需要删除的文件，以使checkout-index成功。

      \ 0输出行终止，不引用文件名。有关详细信息，请参阅下面的OUTPUT。

      1.  -x <pattern>
      1.  --exclude=<pattern>

      跳过与图案匹配的未跟踪文件。请注意，pattern是shell通配符模式。有关详细信息，请参阅下面的EXCLUDE PATTERNS。

      1.  -X <file>
      1.  --exclude-from=<file>

      从< file>中读取排除模式;每行1个。

      1.  --exclude-per-directory=<file>

      阅读仅适用于< file>中的目录及其子目录的其他排除模式。

      1.  --exclude-standard
      1.  --error-unmatch

      如果有任何< file>没有出现在索引中，将其视为错误（返回1）。

      1.  --with-tree=<tree-ish>

      使用—error-unmatch扩展用户提供的< file>时（即路径模式）路径的参数，假装自从命名的< tree-ish>以来在索引中删除的路径。仍然存在。将此选项与-s或-u选项一起使用没有任何意义。

      1.  -t

      此功能已被半弃用。出于脚本目的， --porcelain和 git-diff-files [1] --name-status几乎总是优秀的替代品，用户应该看一下 --short或 git-diff [1] --name-status，用于更加用户友好的替代品。

      此选项在每行的开头标识具有以下标记（后跟空格）的文件状态：

        缓存

        跳worktree

        1.  M

        未合并

        删除/删除

        1.  C

        改性的/改变

        1.  K

        被杀

        1.  ?

        其他

        1.  -v

        与-t类似，但对于标记为的文件使用小写字母假设不变（参见 ）。

        1.  -f

        与-t类似，但对于标记为 fsmonitor有效的文件使用小写字母（参见 git-update-index [1] ）。

        1.  --full-name

        从子目录运行时，该命令通常输出相对于当前目录的路径。此选项强制路径相对于项目顶级目录输出。

        1.  --recurse-submodules

        递归调用存储库中每个子模块上的ls-files。目前只支持—cached模式。

        1.  --abbrev[=<n>]

        不显示完整的40字节十六进制对象行，而是仅显示部分前缀。可以使用—abbrev =< n>指定非默认位数。

        1.  --debug

        在描述文件的每一行之后，添加有关其缓存条目的更多数据。这旨在显示尽可能多的手动检查信息;确切的格式可能随时改变。

        1.  --eol

        “”表示该文件不是常规文件，它不在索引中或在工作树中不可访问。

        < eolattr>是签出或提交时使用的属性，它是“”，“ - text”，“text”，“text = auto”，“text eol = lf”，“text eol = crlf”。由于支持Git 2.10“text = auto eol = lf”和“text = auto eol = crlf”。

        < eolinfo>都是在索引（“i /< eolinfo>”）和工作树（“w /< eolinfo>”）中显示常规文件，然后是（“attr /< eolattr>”）。

        1.  --

        不要将任何更多的参数解释为选项。

        1.  <file>

        要显示的文件。如果没有给出文件，则显示与其他指定条件匹配的所有文件。

        git ls-files 只输出文件名，除非指定了--stage，在这种情况下输出：

        git ls-files —ee 将显示i /< eolinfo>< SPACES> w /< eolinfo>< SPACES> attr /< eolattr>< SPACE *>< TAB> ;<文件>

        git ls-files —unmerged 和 git ls-files —stage 可用于检查未合并路径的详细信息。

        对于未合并的路径，索引不是记录单个模式/ SHA-1对，而是记录最多三个这样的对;一个来自阶段1中的树O，阶段2中的A和阶段3中的B.一个用户（或瓷器）可以使用该信息来查看最终应该在路径上记录的内容。 （有关状态的更多信息，请参见 ）

        如果没有-z选项，则会引用具有“异常”字符的路径名，如配置变量core.quotePath所述（参见 git-config [1] ）。使用，文件名逐字输出，行以NUL字节终止。

        排除模式

        git ls-files 可以在遍历目录树时使用“排除模式”列表，并查找文件以显示指定标志 - 其他或—ignored的时间。 指定排除模式的格式。

        这些排除模式来自这些地方，依次为：

        1. 命令行标志—exclude =< pattern>指定单个模式。模式的排序顺序与它们在命令行中出现的顺序相同。

        2. 命令行标志—exclude-from =< file>指定包含模式列表的文件。模式的排序顺序与文件中出现的顺序相同。

        3. 命令行标志—exclude-per-directory =< name>指定每个目录 git ls-files 检查的文件名，通常是.gitignore。更深层目录中的文件优先。模式的排序顺序与文件中出现的顺序相同。

        在命令行中使用—exclude或从—exclude-from指定的文件读取的模式相对于目录树的顶部。从—exclude-per-directory指定的文件读取的模式是相对于模式文件出现的目录。

        git-read-tree [1] ，

        GIT