• git-ls-files
    • 名称
    • 概要
    • 描述
    • OPTIONS
    • OUTPUT
    • 排除模式
    • 也可以看看
    • GIT

    git-ls-files

    原文： https://git-scm.com/docs/git-ls-files

    名称

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

    概要

    1. git ls-files [-z] [-t] [-v] [-f]
    2.         (--[cached|deleted|others|ignored|stage|unmerged|killed|modified])*
    3.         (-[c|d|o|i|s|u|k|m])*
    4.         [--eol]
    5.         [-x <pattern>|--exclude=<pattern>]
    6.         [-X <file>|--exclude-from=<file>]
    7.         [--exclude-per-directory=<file>]
    8.         [--exclude-standard]
    9.         [--error-unmatch] [--with-tree=<tree-ish>]
    10.         [--full-name] [--recurse-submodules]
    11.         [--abbrev] [--] [<file>…​]

    描述

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

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

    OPTIONS

    1.  -c
    1.  --cached

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

    1.  -d
    1.  --deleted

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

    1.  -m
    1.  --modified

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

    1.  -o
    1.  --others

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

    1.  -i
    1.  --ignored

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

    1.  -s
    1.  --stage

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

    1.  --directory

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

    1.  --no-empty-directory

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

    1.  -u
    1.  --unmerged

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

    1.  -k
    1.  --killed

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

    1.  -z

    \ 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

    添加标准Git排除项：.git / info / exclude，.gitignore在每个目录中，以及用户的全局排除文件。

    1.  --error-unmatch

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

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

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

    1.  -t

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

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

    1.  H

    缓存

    1.  S

    跳worktree

    1.  M

    未合并

    1.  R

    删除/删除

    1.  C

    改性的/改变

    1.  K

    被杀

    1.  ?

    其他

    1.  -v

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

    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

    显示< eolinfo>和< eolattr>的文件。 < eolinfo>是当“text”属性为“auto”（或未设置且core.autocrlf不为false）时Git使用的文件内容标识。 < eolinfo>是“-text”，“none”，“lf”，“crlf”，“mixed”或“”。

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

    < 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>

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

    OUTPUT

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

    1. [<tag> ]<mode> <object> <stage> <file>

    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.一个用户（或瓷器）可以使用该信息来查看最终应该在路径上记录的内容。 （有关状态的更多信息，请参见 git-read-tree [1] ）

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

    排除模式

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

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

    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] ， gitignore [5]

    GIT

    部分 git [1] 套件