设置和配置
获取和创建项目
基本快照
分支与合并
共享和更新项目
检查和比较
打补丁
调试
电子邮件
外部系统
服务器管理
指南
管理
底层命令
- 2.46.1 → 2.50.1 无更改
-
2.46.0
2024-07-29
- 2.44.1 → 2.45.4 无更改
-
2.44.0
2024-02-23
- 2.39.1 → 2.43.7 无更改
-
2.39.0
2022-12-12
- 2.38.1 → 2.38.5 无更改
-
2.38.0
2022-10-02
- 2.30.1 → 2.37.7 无更改
-
2.30.0
2020-12-27
- 2.29.1 → 2.29.3 无更改
-
2.29.0
2020-10-19
- 2.28.1 无更改
-
2.28.0
2020-07-27
- 2.27.1 无更改
-
2.27.0
2020-06-01
- 2.26.1 → 2.26.3 无更改
-
2.26.0
2020-03-22
- 2.25.1 → 2.25.5 无更改
- 2.25.0 无更改
- 2.24.1 → 2.24.4 无更改
-
2.24.0
2019-11-04
- 2.23.1 → 2.23.4 无更改
-
2.23.0
2019-08-16
- 2.19.3 → 2.22.5 无更改
-
2.19.2
2018-11-21
- 2.19.1 无更改
-
2.19.0
2018-09-10
- 2.18.1 → 2.18.5 无更改
-
2.18.0
2018-06-21
概要
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>
命令
- 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]。