名称

git-repo - 获取存储库信息

概要

git repo info [--format=(keyvalue|nul)] [-z] [<key>…​]
git repo structure [--format=(table|keyvalue|nul)]

描述

获取存储库信息。

此命令是实验性的。其行为可能会发生变化。

命令

info [--format=(keyvalue|nul)] [-z] [<key>...]

检索当前存储库中与元数据相关的信息。仅返回基于其键请求的数据（请参阅下面的“信息键”部分）。

值将按请求键的相同顺序返回。

可以通过标志 --format 选择输出格式。支持两种格式：

keyvalue

每行输出一个键值对，使用 = 字符作为键和值之间的分隔符。包含“特殊”字符的值将按照 core.quotePath 配置变量的说明进行引用（请参阅 git-config[1]）。这是默认格式。

nul

与 keyvalue 类似，但使用换行符作为键和值之间的分隔符，并在每个值后使用 NUL 字符。此格式比 keyvalue 更适合被其他应用程序解析。与 keyvalue 格式不同，值永远不会被引用。

-z 是 --format=nul 的别名。

structure [--format=(table|keyvalue|nul)]

检索当前存储库结构的统计信息。报告以下信息：

  • 按类型分类的引用计数

  • 按类型分类的可达对象计数

可以通过标志 --format 选择输出格式。支持三种格式：

+

table

以人类可读的表格形式输出存储库统计信息。此格式可能会发生变化，不适用于机器解析。这是默认格式。

keyvalue

每行输出都包含存储库统计信息的键值对。= 字符用作键和值之间的分隔符。包含“特殊”字符的值将按照 core.quotePath 配置变量的说明进行引用（请参阅 git-config[1]）。

nul

与 keyvalue 类似，但使用 NUL 字符代替换行符来分隔键值对。另外，使用换行符代替 = 作为键和值之间的分隔符。与 keyvalue 格式不同，包含“特殊”字符的值永远不会被引用。

信息键

为了从 git repo info 获取一组值，您应该提供标识这些值的键。以下是可用键及其返回值的列表：

layout.bare

如果这是裸存储库，则为 true，否则为 false。

layout.shallow

如果这是浅层存储库，则为 true，否则为 false。

object.format

存储库中使用的对象格式（哈希算法）。

references.format

引用存储格式。有效值为：

  • files 表示带有 packed-refs 的松散文件。这是默认值。

  • reftable 表示 reftable 格式。此格式是实验性的，其内部结构可能会更改。

示例

  • 检索当前存储库的引用格式

    git repo info references.format

  • 使用 nul 格式检索当前存储库是否为裸存储库以及是否为浅层存储库

    git repo info --format=nul layout.bare layout.shallow

另请参阅

git-rev-parse[1]

GIT

Git[1] 套件的一部分