• git-show-ref
    • 名称
    • 概要
    • 描述
    • OPTIONS
    • OUTPUT
    • 例子
    • FILES
    • 也可以看看
    • GIT

    git-show-ref

    原文： https://git-scm.com/docs/git-show-ref

    名称

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

    概要

    1. git show-ref [-q|--quiet] [--verify] [--head] [-d|--dereference]
    2.          [-s|--hash[=<n>]] [--abbrev[=<n>]] [--tags]
    3.          [--heads] [--] [<pattern>…​]
    4. git show-ref --exclude-existing[=<pattern>]

    描述

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

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

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

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

    OPTIONS

    1.  --head

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

    1.  --heads
    1.  --tags

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

    1.  -d
    1.  --dereference

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

    1.  -s
    1.  --hash[=<n>]

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

    1.  --verify

    通过要求精确的ref路径来启用更严格的引用检查。除了返回错误代码1之外，如果未指定--quiet，它还将打印错误消息。

    1.  --abbrev[=<n>]

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

    1.  -q
    1.  --quiet

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

    1.  --exclude-existing[=<pattern>]

    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. 832e76a9899f560a90ffd62ae2ce83bbeff58f54 refs/heads/origin
    5. 3521017556c5de4159da4615a39fa4d5d2c279b5 refs/tags/v0.99.9c
    6. 6ddc0964034342519a87fe013781abf31c6db6ad refs/tags/v0.99.9c^{}
    7. 055e4ae3ae6eb344cbabf2a5256a49ea66040131 refs/tags/v1.0rc4
    8. 423325a2d24638ddcc82ce47be5e40be550f4507 refs/tags/v1.0rc4^{}
    9. ...

    当使用—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标志时，该命令需要一个确切的路径：

    1.     git show-ref --verify refs/heads/master

    只会匹配名为“master”的确切分支。

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

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

    1.     git show-ref --quiet --verify -- "refs/heads/$headname" ||
    2.         echo "$headname is not a valid branch"

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

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

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

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

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

    FILES

    .git/refs/*，.git/packed-refs

    也可以看看

    git-for-each-ref [1] ， git-ls-remote [1] ， git-update-ref [1] ， gitrepository-layout [5]

    GIT

    部分 git [1] 套件