如果给出了一个或多个 <pattern> 参数，则仅显示匹配至少一个模式的引用，匹配方式可以使用 fnmatch(3) 或字面匹配，后者为完全匹配或从开头到斜杠的匹配。

从标准输入而不是命令行参数列表中读取模式列表。

显示 <count> 个引用后停止。

按字段名 <key> 排序。添加前缀 - 表示按值降序排列。未指定时，默认使用 refname。您可以多次使用 --sort=<key> 选项，在这种情况下，最后一个键成为主键。

一个字符串，内插来自显示的引用及其指向对象的 %(fieldname)。此外，字符串字面量 %% 渲染为 %，而 %xx（其中 xx 是十六进制数字）渲染为具有十六进制代码 xx 的字符。例如，%00 内插为 \0 (NUL)，%09 为 \t (TAB)，%0a 为 \n (LF)。

尊重 --format 选项中指定的任何颜色。<when> 字段必须是 always、never 或 auto 之一（如果缺少 <when>，其行为等同于 always）。

如果给出，则替换 %(fieldname) 占位符的字符串会被引用为适合指定宿主语言的字符串字面量。这旨在生成一个可以直接被 "eval" 处理的小脚本。

仅列出指向给定对象的引用。

仅列出其端点可从指定提交（如果未指定则为 HEAD）到达的引用。

仅列出其端点不可从 <object>（如果未指定则为 HEAD）到达的引用。

仅列出包含 <object>（如果未指定则为 HEAD）的引用。

仅列出不包含 <object>（如果未指定则为 HEAD）的引用。

对引用的排序和过滤不区分大小写。

在格式化引用中，如果格式扩展为空字符串，则不在其后打印换行符。

如果给出了一个或多个 --exclude 选项，则仅显示不匹配任何 <excluded-pattern> 参数的引用。匹配规则与上述 <pattern> 相同。

除常规引用外，还列出根引用（HEAD 和伪引用）。

通过跳过直到并包括指定标记的引用来对输出进行分页。分页时应注意，引用可能在两次调用之间被删除、修改或添加。输出将仅产生按字典顺序排在标记之后的引用。输出从按字母顺序排在标记之后的第一个引用开始。不能与 --sort=<key> 或 --stdin 选项一起使用，也不能使用 <pattern> 参数来限制引用。

引用的名称（$GIT_DIR/ 之后的部分）。对于引用的无歧义短名称，请追加 :short。选项 core.warnAmbiguousRefs 用于选择严格缩写模式。如果追加了 lstrip=<n> (rstrip=<n>)，则从 refname 的前面（后面）剥离 <n> 个斜杠分隔的路径组件（例如 %(refname:lstrip=2) 将 refs/tags/foo 变为 foo，而 %(refname:rstrip=2) 将 refs/tags/foo 变为 refs）。如果 <n> 是负数，则从指定的一端剥离尽可能多的路径组件，以留下 -<n> 个路径组件（例如 %(refname:lstrip=-2) 将 refs/tags/foo 变为 tags/foo，而 %(refname:rstrip=-1) 将 refs/tags/foo 变为 refs）。当引用没有足够的组件时，如果使用正数 <n> 剥离，结果为空字符串；如果使用负数 <N> 剥离，则结果为完整 refname。两者均不视为错误。

对象的类型（blob、tree、commit、tag）。

对象的大小（与 git cat-file -s 报告的相同）。追加 :disk 以获取对象在磁盘上占用的字节大小。请参阅下面 CAVEATS（注意事项） 部分中关于磁盘大小的说明。

对象名称（即 SHA-1）。对于对象名称的无歧义缩写，请追加 :short。对于具有所需长度的对象名称缩写，请追加 :short=<length>，其中最小长度为 MINIMUM_ABBREV。长度可能会超过此值以确保对象名称的唯一性。

如果给定对象以增量（delta）形式存储，则此项扩展为增量基底的对象名称。否则，它扩展为空对象名称（全零）。

一个本地引用的名称，它可以被视为显示引用的“上游”。以与上述 refname 相同的方式遵循 :short、:lstrip 和 :rstrip。此外遵循 :track 来显示 "[ahead N, behind M]" 以及 :trackshort 来显示简明版本：">"（领先）、"<"（落后）、"<>"（领先且落后）或 "="（同步）。当遇到未知的上游引用时，:track 还会打印 "[gone]"。追加 :track,nobracket 以显示不带括号的追踪信息（即 "ahead N, behind M"）。

代表显示引用的 @{push} 位置的本地引用名称。与 upstream 一样遵循 :short、:lstrip、:rstrip、:track、:trackshort、:remotename 和 :remoteref 选项。如果未配置 @{push} 引用，则产生空字符串。

如果 HEAD 匹配当前引用（检出的分支）则为 *，否则为空格 ' '。

更改输出颜色。后跟 :<colorname>，其中颜色名称在 git-config[1] 的“CONFIGURATION FILE”部分的 Values 下描述。例如，%(color:bold red)。

将 %(align:...) 和 %(end) 之间的内容左对齐、居中对齐或右对齐。"align:" 后面跟着 width=<width> 和 position=<position>，顺序不限，用逗号分隔，其中 <position> 可以是 left、right 或 middle，默认值为 left，而 <width> 是对齐内容的总长度。为了简便，可以省略 "width=" 和/或 "position=" 前缀，而直接使用 <width> 和 <position>。例如，%(align:<width>,<position>)。如果内容长度超过宽度，则不执行对齐。如果与 --quote 一起使用，%(align:...) 和 %(end) 之间的所有内容都会被引用，但如果是嵌套的，则只有最顶层执行引用。

用法如 %(if)...%(then)...%(end) 或 %(if)...%(then)...%(else)...%(end)。如果在 %(if) 之后有一个带有值或字符串字面量的原子，则打印 %(then) 之后的所有内容，否则如果使用了 %(else) 原子，则打印 %(else) 之后的所有内容。我们在评估 %(then) 之前的字符串时会忽略空格，当我们使用打印 "*" 或 " " 的 %(HEAD) 原子，并且只想对 HEAD 引用应用 if 条件时，这很有用。追加 ":equals=<string>" 或 ":notequals=<string>" 以将 %(if:...) 和 %(then) 原子之间的值与给定字符串进行比较。

给定符号引用所指向的引用。如果不是符号引用，则不打印任何内容。以与上述 refname 相同的方式遵循 :short、:lstrip 和 :rstrip 选项。

提交的 GPG 签名。

显示：

提交的 GPG 签名的签署者。

提交的 GPG 签名的密钥。

提交的 GPG 签名的指纹。

提交的 GPG 签名的主键指纹。

提交的 GPG 签名的信任级别。可能的输出包括 ultimate（绝对信任）、fully（完全信任）、marginal（有限信任）、never（从不信任）和 undefined（未定义）。

检出该引用的工作区的绝对路径（如果它在任何链接的工作区中被检出）。否则为空字符串。

两个整数，由空格分隔，分别表示将输出引用与格式中指定的 <commit-ish> 进行比较时，领先和落后的提交数量。

在最多一行中，会出现 (<commit-ish>) 以指示最有可能作为产生 <commit-ish> 的分支起点的引用。此选择使用启发式方法：选择使处于 <commit-ish> 的第一父级历史中但不在该引用的第一父级历史中的提交数量最少的引用。

*--*--*--*--*--* refs/heads/A
\
 \
  *--*--*--* refs/heads/B
   \     \
    \     \
     *     * refs/heads/C
      \
       \
	*--* refs/heads/D

refs/heads/A:
refs/heads/B:(D)
refs/heads/C:

一个人类可读的名称，类似于 git-describe[1]；对于无法描述的提交为空字符串。describe 字符串后面可以跟一个冒号和一个或多个逗号分隔的选项。

对象的原始数据大小。

提交或标签消息的字节大小。

消息的第一段（通常是单行）被视为提交或标签消息的“主题”。可以使用字段 subject 代替 contents:subject 以获得相同结果。可以向 subject 追加 :sanitize，以获取适合作为文件名的主题行。

提交或标签消息中紧随“主题”之后的剩余部分。

标签的可选 GPG 签名。

消息的前 <n> 行。