简体中文 ▾ 主题 ▾ 最新版本 ▾ git-commit-graph 最后更新于 2.46.0

名称

git-commit-graph - 写入和验证 Git 提交图文件

概要

git commit-graph verify [--object-dir <dir>] [--shallow] [--[no-]progress]
git commit-graph write [--object-dir <dir>] [--append]
			[--split[=<strategy>]] [--reachable | --stdin-packs | --stdin-commits]
			[--changed-paths] [--[no-]max-new-filters <n>] [--[no-]progress]
			<split-options>

描述

管理序列化的提交图文件。

选项

--object-dir

使用给定目录作为 packfile 和提交图文件的位置。此参数用于指定仅包含对象目录而不包含完整 .git 目录的备用位置。提交图文件应位于 <dir>/info 目录中,packfile 应位于 <dir>/pack 目录中。如果目录无法转换为绝对路径,或者与任何已知对象目录不匹配,则 git commit-graph ... 将以非零状态退出。

--[no-]progress

明确开启/关闭进度显示。如果未指定,则当标准错误连接到终端时显示进度。

命令

write

根据 packfile 中找到的提交写入提交图文件。如果配置选项 core.commitGraph 被禁用,则此命令将输出警告,然后成功返回而不写入提交图文件。

使用 --stdin-packs 选项,仅通过遍历指定 pack 索引中的对象来生成新的提交图。(不能与 --stdin-commits--reachable 结合使用。)

使用 --stdin-commits 选项,通过从标准输入中指定为十六进制 OID 列表的提交(每行一个 OID)开始遍历提交来生成新的提交图。解析为非提交的 OID(直接或通过剥离标签)会被静默忽略。格式错误或不存在的 OID 会生成错误。(不能与 --stdin-packs--reachable 结合使用。)

使用 --reachable 选项,通过从所有引用开始遍历提交来生成新的提交图。(不能与 --stdin-commits--stdin-packs 结合使用。)

使用 --append 选项,包含现有提交图文件中存在的所有提交。

使用 --changed-paths 选项,计算并写入提交与其第一个父项之间更改的路径信息。此操作在大型仓库中可能需要一段时间。它为使用 git log -- <path> 获取目录或文件的历史记录提供了显著的性能提升。如果给出此选项,则未来的提交图写入将自动假定此选项是预期的。使用 --no-changed-paths 停止存储此数据。

使用 --max-new-filters=<n> 选项,最多生成 n 个新的布隆过滤器(如果指定了 --changed-paths)。如果 n-1,则不强制执行限制。只有新层中存在的提交才计入此限制。要追溯计算早期层的布隆过滤器,建议使用 --split=replace。覆盖 commitGraph.maxNewFilters 配置。

使用 --split[=<strategy>] 选项,将提交图写入存储在 <dir>/info/commit-graphs 中的多个提交图文件的链。提交图层根据策略和其他拆分选项进行合并。尚未在提交图中的新提交将添加到新的“尖端”文件中。如果满足以下合并条件,此文件将与现有文件合并:

  • 如果指定了 --split=no-merge,则永不执行合并,其余选项将被忽略。--split=replace 用一个新的链覆盖现有链。单独的 --split 选项将推迟到其余选项。(请注意,合并提交图链会将现有链替换为长度为 1 的链,其中第一个也是唯一的增量包含整个图。)

  • 如果未指定 --size-multiple=<X>,则让 X 等于 2。如果新尖端文件将包含 N 个提交,而前一个尖端文件包含 M 个提交,并且 X 乘以 N 大于 M,则将这两个文件合并为一个文件。

  • 如果指定了 --max-commits=<M>,其中 M 是一个正整数,并且新尖端文件将包含超过 M 个提交,则将新尖端与前一个尖端合并。

    最后,如果未指定 --expire-time=<datetime>,则让 datetime 为当前时间。写入拆分提交图后,删除所有修改时间早于 datetime 的未使用提交图。

verify

读取提交图文件并根据对象数据库验证其内容。用于检查损坏的数据。

使用 --shallow 选项,在拆分提交图链中仅检查尖端提交图文件。

示例

  • 为本地 .git 目录中的 packed commits 写入一个提交图文件。

    $ git commit-graph write
  • 写入一个提交图文件,使用 <pack-index> 中的提交扩展当前提交图文件。

    $ echo <pack-index> | git commit-graph write --stdin-packs
  • 写入一个包含所有可达提交的提交图文件。

    $ git show-ref -s | git commit-graph write --stdin-commits
  • 写入一个包含当前提交图文件中所有提交以及从 HEAD 可达的提交的提交图文件。

    $ git rev-parse HEAD | git commit-graph write --stdin-commits --append

配置

本节中以下所有内容均从 git-config[1] 文档中选择性地包含。内容与彼处相同:

commitGraph.generationVersion

指定写入或读取提交图文件时使用的生成号版本类型。如果指定版本 1,则不会写入或读取更正后的提交日期。默认为 2。

commitGraph.maxNewFilters

指定 git commit-graph write--max-new-filters 选项的默认值(参见 git-commit-graph[1])。

commitGraph.readChangedPaths

已弃用。如果为 true,则等同于 commitGraph.changedPathsVersion=-1;如果为 false,则等同于 commitGraph.changedPathsVersion=0。(如果同时设置了 commitGraph.changedPathVersion,则 commitGraph.changedPathsVersion 优先。)

commitGraph.changedPathsVersion

指定 Git 将读取和写入的已更改路径布隆过滤器的版本。可以是 -1、0、1 或 2。请注意,大于 1 的值可能与尚未理解这些版本的老版本 Git 不兼容。在混合版本环境中操作时请谨慎。

默认为 -1。

如果为 -1,Git 将使用仓库中已更改路径布隆过滤器的版本,如果不存在则默认为 1。

如果为 0,Git 将不读取任何布隆过滤器,并在指示写入时写入版本 1 的布隆过滤器。

如果为 1,Git 将只读取版本 1 的布隆过滤器,并写入版本 1 的布隆过滤器。

如果为 2,Git 将只读取版本 2 的布隆过滤器,并写入版本 2 的布隆过滤器。

有关更多信息,请参见 git-commit-graph[1]

文件格式

GIT

Git[1] 套件的一部分

scroll-to-top