简体中文 ▾ 主题 ▾ 最新版本 ▾ git-check-attr 最后更新于 2.50.0

名称

git-check-attr - 显示 gitattributes 信息

概要

git check-attr [--source <tree-ish>] [-a | --all | <attr>…​] [--] <pathname>…​
git check-attr --stdin [-z] [--source <tree-ish>] [-a | --all | <attr>…​]

描述

对于每个路径名，此命令将列出每个属性在该路径名上是否被未指定、已设置或未设置为 git 属性。

选项

-a, --all

列出与指定路径关联的所有属性。如果使用此选项，则输出中将不包含未指定的属性。

--cached

仅考虑索引中的 .gitattributes，忽略工作区。

--stdin

从标准输入（每行一个）读取路径名，而不是从命令行读取。

-z

输出格式被修改为机器可解析的。如果同时给定 --stdin，则输入路径将使用 NUL 字符而不是换行符分隔。

--source=<tree-ish>

对照指定的 tree-ish 检查属性。通常通过命名与其关联的提交、分支或标签来指定源树。

--

将所有前面的参数解释为属性，将所有后面的参数解释为路径名。

如果 --stdin、--all 或 -- 均未使用，则第一个参数将被视为属性，其余参数被视为路径名。

输出

输出格式为：<path> COLON SP <attribute> COLON SP <info> LF

除非 -z 生效，在这种情况下，NUL 用作分隔符：<path> NUL <attribute> NUL <info> NUL

<path> 是正在查询的文件的路径，<attribute> 是正在查询的属性，而 <info> 可以是以下之一：

未指定

当该属性未为路径定义时。

未设置

当该属性定义为 false 时。

已设置

当该属性定义为 true 时。

<值>

当一个值已分配给该属性时。

缓冲按照 git[1] 中 GIT_FLUSH 选项的文档进行。调用者有责任避免因输入缓冲区溢出或从空输出缓冲区读取而导致的死锁。

示例

在示例中，使用以下 .gitattributes 文件

*.java diff=java -crlf myAttr
NoMyAttr.java !myAttr
README caveat=unspecified

  • 列出单个属性

    $ git check-attr diff org/example/MyClass.java
org/example/MyClass.java: diff: java

  • 列出文件的多个属性

    $ git check-attr crlf diff myAttr -- org/example/MyClass.java
org/example/MyClass.java: crlf: unset
org/example/MyClass.java: diff: java
org/example/MyClass.java: myAttr: set

  • 列出文件的所有属性

    $ git check-attr --all -- org/example/MyClass.java
org/example/MyClass.java: diff: java
org/example/MyClass.java: myAttr: set

  • 列出多个文件的属性

    $ git check-attr myAttr -- org/example/MyClass.java org/example/NoMyAttr.java
org/example/MyClass.java: myAttr: set
org/example/NoMyAttr.java: myAttr: unspecified

  • 并非所有值都同样明确

    $ git check-attr caveat README
README: caveat: unspecified

另请参阅

gitattributes[5].

GIT

Git[1] 套件的一部分

scroll-to-top