git-show-ref

    git-show-ref - 列出本地存储库中的引用

    概要

    描述

    显示本地存储库中可用的引用以及关联的提交ID。可以使用模式过滤结果，并且可以将标记解除引用到对象ID中。此外，它还可用于测试特定引用是否存在。

    默认情况下，显示标签，磁头和远程参考。

    —exclude-existing表单是一个反向的过滤器。它从stdin读取refs，每行一个ref，并显示本地存储库中不存在的那些。

    鼓励使用此实用程序，以便直接访问目录下的文件。

    1.  --head

    显示HEAD引用，即使它通常会被过滤掉。

    1.  --heads

      分别限于“refs / heads”和“refs / tags”。这些选择并不相互排斥;当给出两者时，显示存储在“refs / heads”和“refs / tags”中的引用。

      1.  -d
      1.  --dereference

      取消引用标记到对象ID中。它们将显示为附加“^ {}”。

      1.  --hash[=<n>]

      仅显示SHA-1哈希值，而不是引用名称。与—dereference结合使用时，仍会在SHA-1之后显示解除引用的标记。

      1.  --verify
      1.  --abbrev[=<n>]

      缩写对象名称。使用--hash时，您不必说--hash --abbrev; 会这样做。

      1.  -q
      1.  --quiet

      不要将任何结果打印到stdout。与--verify结合使用时，可以用于静默检查是否存在引用。

      Make git show-ref 充当从“^(?:&lt;anything&gt;\s)?&lt;refname&gt;(?:\^{})?$”形式的stdin读取refs的过滤器，并对每个执行以下操作：（1）在行尾添加“^ {}”如果有的话（2）忽略是否提供了模式并且不匹配refname; （3）警告refname不是格式良好的refname并跳过; （4）忽略refname是否是本地存储库中存在的ref; （5）否则输出该行。

      1.  <pattern>…​

      显示与一个或多个模式匹配的引用。模式从全名的末尾匹配，并且仅匹配完整的部分，例如， master 匹配 refs / heads / master ， refs / remotes / origin / master ， refs / tags / jedi / master 但不 refs / heads / mymaster 或 refs / remotes / master / jedi 。

      OUTPUT

      输出格式为：< SHA-1 ID> < space> <参考名称> 。

      1. $ git show-ref --head --dereference
      2. 832e76a9899f560a90ffd62ae2ce83bbeff58f54 HEAD
      3. 832e76a9899f560a90ffd62ae2ce83bbeff58f54 refs/heads/master
      4. 3521017556c5de4159da4615a39fa4d5d2c279b5 refs/tags/v0.99.9c
      5. 6ddc0964034342519a87fe013781abf31c6db6ad refs/tags/v0.99.9c^{}
      7. 423325a2d24638ddcc82ce47be5e40be550f4507 refs/tags/v1.0rc4^{}
      8. ...

      当使用—hash（而不是—dereference）时，输出格式为：< SHA-1 ID>

      1. $ git show-ref --heads --hash
      2. 2e3ba0114a1f52b47df29743d6915d056be13278
      3. 185008ae97960c8d551adcd9e23565194651b5d1
      4. 03adf42c988195b50e1a1935ba5fcbc39b2b029b
      5. ...

      例子

      要显示所有称为“master”的引用，无论是标记还是标题或其他任何内容，并且无论它们的引用命名层次结构有多深，请使用：

      1.     git show-ref master

      如果存在这样的引用，这将显示“refs / heads / master”以及“refs / remote / other-repo / master”。

      使用--verify标志时，该命令需要一个确切的路径：

        如果没有匹配， git show-ref 将返回错误代码1，并且在验证的情况下，它将显示错误消息。

        对于脚本，你可以要求它安静地使用“—quiet”标志，它可以让你做类似的事情

        检查特定分支是否存在（请注意我们实际上不想显示任何结果，并且我们希望使用完整的refname以便不会触发模糊部分匹配的问题）。

        要仅显示标记或仅显示正确的分支头，请分别使用“—tags”和/或“—heads”（使用两者表示它显示标记和头部，但不显示refs /子目录下的其他随机引用）。

        要进行自动标记对象解除引用，请使用“-d”或“—dereference”标志，这样就可以了

        1.     git show-ref --tags --dereference

        获取所有标签的列表以及它们取消引用的内容。

        ，.git/packed-refs

        也可以看看

        ， git-ls-remote [1] ， ， gitrepository-layout [5]

        GIT

        部分 套件