gitdir: 关键字后面的数据用作全局模式。如果 .git 目录的位置与模式匹配，则满足包含条件。

这与 gitdir 相同，只是匹配不区分大小写（例如，在不区分大小写的文件系统上）

紧跟关键字onbranch:之后的数据被视为一个模式，该模式使用标准的通配符以及两个额外的通配符**/和/**，它们可以匹配多个路径组件。如果我们在一个工作树中，并且当前签出的分支名称与该模式匹配，则满足包含条件。

紧跟此关键字之后的数据被视为一个模式，该模式使用标准的通配符以及两个额外的通配符**/和/**，它们可以匹配多个组件。第一次遇到此关键字时，将扫描其余的配置文件以查找远程URL（不应用任何值）。如果存在至少一个与该模式匹配的远程URL，则满足包含条件。

当一个变量被认为采用布尔值时，会接受许多true和false的同义词；这些都是不区分大小写的。

许多指定各种大小的变量的值可以后缀k、M等，表示“将数字乘以1024”、“乘以1024x1024”等。

采用颜色的变量的值是一个颜色列表（最多两个，一个用于前景色，一个用于背景色）和属性（任意多个），用空格分隔。

采用路径名值的变量可以被赋予一个以“~/”或“~user/”开头的字符串，并且对这样的字符串执行通常的波浪号扩展：~/扩展为$HOME的值，~user/扩展为指定用户的家目录。

告诉git add在某些文件由于索引错误而无法添加时继续添加文件。等效于git-add[1]的--ignore-errors选项。add.ignore-errors已弃用，因为它不遵循配置变量的常用命名约定。

这些变量控制各种可选帮助消息，这些消息旨在帮助新用户。当未配置时，Git 将在有关如何消除它的说明旁边提供该消息。您可以告诉Git您已经了解了问题，不再需要特定帮助消息，方法是将相应的变量设置为false。

用于 git[1] 命令包装器的命令别名 - 例如，在定义 alias.last = cat-file commit HEAD 后，调用 git last 等效于 git cat-file commit HEAD。为了避免与脚本使用混淆和麻烦，隐藏现有 Git 命令的别名将被忽略。参数以空格分隔，支持常见的 shell 引号和转义。可以使用一对引号或反斜杠来引用它们。

如果为 true，则 git-am 将为 mbox 格式的补丁调用 git-mailsplit，并使用参数 --keep-cr。在这种情况下，git-mailsplit 不会从以 \r\n 结尾的行中删除 \r。可以通过从命令行给出 --no-keep-cr 来覆盖。请参阅 git-am[1]、git-mailsplit[1]。

默认情况下，如果补丁未干净地应用，则 git am 将失败。当设置为 true 时，此设置告诉 git am 如果补丁记录了它应该应用的 blob 的标识，并且我们本地有这些 blob 可用，则回退到 3 路合并（相当于从命令行给出 --3way 选项）。默认为 false。请参阅 git-am[1]。

当设置为 change 时，告诉 git apply 忽略空格更改，与 --ignore-space-change 选项相同。当设置为以下之一时：no、none、never、false，它告诉 git apply 尊重所有空格差异。请参阅 git-apply[1]。

告诉 git apply 如何处理空格，与 --whitespace 选项相同。请参阅 git-apply[1]。

引用存储库中的一棵树来读取属性，而不是工作树中的.gitattributes文件。如果该值无法解析为有效的树对象，则使用空树代替。当使用GIT_ATTR_SOURCE环境变量或--attr-source命令行选项时，此配置变量无效。

用于匹配引用名称的正则表达式。指向与该模式匹配的引用的提交（并满足以下条件，例如bitmapPseudoMerge.<name>.sampleRate和bitmapPseudoMerge.<name>.threshold）将被视为包含在伪合并位图中。

确定连续伪合并位图组大小减小的速率。必须是非负数。此参数可以被认为是函数f(n) = C * n^-k中的k，其中f(n)是第n个组的大小。

确定非位图提交（在引用提示中）中选择包含在不稳定伪合并位图中的比例。必须在0和1（含）之间。默认值为1。

确定非位图提交（如上所述，在引用提示中）的最小年龄，这些提交是包含在不稳定伪合并位图中的候选者。默认值为1.week.ago。

确定提交可能分布在其间的伪合并提交的最大数量。

确定提交的最小年龄（如上所述，在引用提示中，但是即使稳定提交已被位图覆盖，它们仍然被视为候选者），这些提交是稳定伪合并位图的候选者。默认值为1.month.ago。

确定稳定伪合并位图的大小（以提交数表示）。默认值为512。

在git-blame[1]中显示边界提交的空白提交对象名称。此选项默认为false。

这决定了应用于归责输出的着色方案。它可以是repeatedLines、highlightRecent或none，后者是默认值。

指定在git-blame[1]中用于输出日期的格式。如果未设置，则使用iso格式。有关支持的值，请参阅git-log[1]中对--date选项的讨论。

在git-blame[1]中显示作者电子邮件而不是作者姓名。此选项默认为false。

在git-blame[1]中不要将根提交视为边界。此选项默认为false。

在git-blame[1]中忽略文件中列出的修订版，每行一个未缩写的对象名称。空格和以#开头的注释将被忽略。此选项可以重复多次。空文件名将重置已忽略修订版的列表。此选项将在命令行选项--ignore-revs-file之前处理。

在git-blame[1]的输出中，用*标记由已忽略的修订版更改的行，但我们无法将其归因于其他提交。

在git-blame[1]的输出中，用?标记由已忽略的修订版更改的行，但我们将其归因于其他提交。

告诉git branch、git switch和git checkout设置新分支，以便git-pull[1]将从起始点分支适当地合并。请注意，即使未设置此选项，也可以使用--track和--no-track选项为每个分支选择此行为。有效设置包括：false — 不执行自动设置；true — 当起始点是远程跟踪分支时执行自动设置；always — 当起始点是本地分支或远程跟踪分支时执行自动设置；inherit — 如果起始点具有跟踪配置，则将其复制到新分支；simple — 仅当起始点是远程跟踪分支且新分支与远程分支具有相同的名称时执行自动设置。此选项默认为true。

当使用git branch、git switch或git checkout创建一个跟踪另一个分支的新分支时，此变量告诉Git将pull设置为rebase而不是merge（参见“branch.<name>.rebase”）。当为never时，rebase永远不会自动设置为true。当为local时，对于其他本地分支的跟踪分支，rebase将设置为true。当为remote时，对于远程跟踪分支的跟踪分支，rebase将设置为true。当为always时，对于所有跟踪分支，rebase都将设置为true。有关如何设置分支以跟踪另一个分支的详细信息，请参阅“branch.autoSetupMerge”。此选项默认为never。

此变量控制git-branch[1]显示分支时的排序顺序。如果没有提供“--sort=<value>”选项，则此变量的值将用作默认值。有关有效值，请参阅git-for-each-ref[1]字段名称。

在<name>分支上时，它告诉git fetch和git push从哪个远程获取或推送到哪个远程。要推送到远程可以使用remote.pushDefault（适用于所有分支）覆盖。要推送到远程，对于当前分支，可以使用branch.<name>.pushRemote进一步覆盖。如果没有配置远程，或者您不在任何分支上并且存储库中定义了多个远程，则默认情况下，获取操作使用origin，推送操作使用remote.pushDefault。此外，.（句点）是当前本地存储库（点存储库），请参阅下面branch.<name>.merge的最后一条说明。

在<name>分支上时，它会覆盖branch.<name>.remote以进行推送。它还会覆盖remote.pushDefault以从<name>分支推送。当您从一个地方（例如您的上游）拉取并推送到另一个地方（例如您自己的发布存储库）时，您可能希望设置remote.pushDefault以指定要为所有分支推送到哪个远程，并使用此选项覆盖特定分支的设置。

与 branch.<name>.remote 共同定义给定分支的上游分支。它告诉 git fetch/git pull/git rebase 合并哪个分支，也可能影响 git push（参见 push.default）。在分支 <name> 中，它告诉 git fetch 要在 FETCH_HEAD 中标记以进行合并的默认 refspec。该值像 refspec 的远程部分一样处理，并且必须与从 "branch.<name>.remote" 指定的远程获取的 ref 匹配。合并信息由 git pull（它首先调用 git fetch）用于查找要合并的默认分支。如果没有此选项，git pull 默认合并第一个获取的 refspec。指定多个值以获取章鱼合并。如果希望设置 git pull 以便它从本地存储库中的另一个分支合并到 <name> 中，可以将 branch.<name>.merge 指向所需的分支，并为 branch.<name>.remote 使用相对路径设置 .（句点）。

设置合并到分支 <name> 的默认选项。语法和支持的选项与 git-merge[1] 的相同，但目前不支持包含空格字符的选项值。

如果为真，则将分支 <name> 重新定位到已获取分支的顶部，而不是在运行 "git pull" 时合并来自默认远程的默认分支。有关以非分支特定方式执行此操作，请参阅 "pull.rebase"。

分支描述，可以使用 git branch --edit-description 编辑。分支描述会自动添加到 format-patch 邮件封面或 request-pull 摘要中。

指定要调用的指定浏览器的命令。指定的命令在 shell 中使用 URL 作为参数进行评估。（参见 git-web--browse[1]。）

覆盖可能用于浏览 HTML 帮助（参见 git-help[1] 中的 -w 选项）或 gitweb 中的工作存储库（参见 git-instaweb[1]）的给定工具的路径。

bundle.* 密钥可能出现在通过 git clone --bundle-uri 选项找到的 bundle 列表文件中。如果放在存储库配置文件中，这些密钥目前没有效果，尽管这将在将来发生变化。有关更多详细信息，请参阅 bundle URI 设计文档。

此整数值宣传 bundle 列表使用的 bundle 列表格式的版本。目前，唯一接受的值是 1。

此字符串值应为 all 或 any。此值描述是否需要所有已发布的 bundle 才能解包对 bundle 信息的完整理解（all），或者是否列出的任何一个 bundle URI 就足够了（any）。

如果此字符串值密钥存在，则 bundle 列表旨在与增量 git fetch 命令配合使用。启发式表示每个 bundle 可用其他密钥来帮助确定客户端应下载的 bundle 子集。目前唯一理解的值是 creationToken。

bundle.<id>.* 密钥用于描述 bundle 列表中的单个项目，在 <id> 下分组以进行识别。

此字符串值定义 Git 可以通过其访问此 <id> 内容的 URI。此 URI 可以是 bundle 文件或其他 bundle 列表。

当您运行 git checkout <something> 或 git switch <something> 并且只有一个远程时，它可能会隐式回退到检出和跟踪例如 origin/<something>。一旦您有多个具有 <something> 引用，此操作将停止工作。此设置允许设置首选远程的名称，该名称在消除歧义时始终优先。典型用例是将其设置为 origin。

提供 git checkout 和 git switch 中 --guess 或 --no-guess 选项的默认值。参见 git-switch[1] 和 git-checkout[1]。

更新工作树时使用的并行工作程序数量。默认值为 1，即顺序执行。如果设置为小于 1 的值，Git 将使用与可用逻辑核心数量一样多的工作程序。此设置和 checkout.thresholdForParallelism 会影响执行检出的所有命令。例如 checkout、clone、reset、sparse-checkout 等。

使用少量文件运行并行检出时，子进程生成和进程间通信的成本可能会超过并行化的收益。此设置允许您定义应尝试进行并行检出的文件的最小数量。默认为 100。

一个布尔值，使 git-clean 拒绝删除文件，除非给出 -f。默认为 true。

克隆存储库时要创建的远程的名称。默认为 origin。可以通过将 --origin 命令行选项传递给 git-clone[1] 来覆盖它。

如果存储库是浅存储库，则拒绝克隆它；这可以通过在命令行上传递 --reject-shallow 选项来覆盖。参见 git-clone[1]。

如果提供了部分克隆过滤器（参见 git-rev-list[1] 中的 --filter）并使用了 --recurse-submodules，则也将过滤器应用于子模块。

一个布尔值，用于启用/禁用提示中的颜色（例如，当推送失败时，请参阅 advice.* 以获取列表）。可以设置为 always、false（或 never）或 auto（或 true），在这种情况下，仅当错误输出转到终端时才使用颜色。如果未设置，则使用 color.ui 的值（默认为 auto）。

为提示使用自定义颜色。

根据行的年龄，为 git blame --color-by-age 指定行注释颜色。

使用指定的颜色为 git blame --color-lines 着色行注释，如果它们来自与前一行相同的提交。默认为青色。

一个布尔值，用于启用/禁用 git-branch[1] 输出中的颜色。可以设置为 always、false（或 never）或 auto（或 true），在这种情况下，仅当输出到终端时才使用颜色。如果未设置，则使用 color.ui 的值（默认为 auto）。

为分支着色使用自定义颜色。<slot> 是 current（当前分支）、local（本地分支）、remote（refs/remotes/ 中的远程跟踪分支）、upstream（上游跟踪分支）、plain（其他 refs）之一。

是否使用 ANSI 转义序列向补丁添加颜色。如果将其设置为 always，则 git-diff[1]、git-log[1] 和 git-show[1] 将为所有补丁使用颜色。如果将其设置为 true 或 auto，则这些命令仅在输出到终端时才使用颜色。如果未设置，则使用 color.ui 的值（默认为 auto）。

为 diff 着色使用自定义颜色。<slot> 指定要使用指定颜色的补丁的哪个部分，并且是 context（上下文文本 - plain 是历史同义词）、meta（元信息）、frag（块标题）、func（块标题中的函数）、old（删除的行）、new（添加的行）、commit（提交标题）、whitespace（突出显示空格错误）、oldMoved（删除的行）、newMoved（添加的行）、oldMovedDimmed、oldMovedAlternative、oldMovedAlternativeDimmed、newMovedDimmed、newMovedAlternative newMovedAlternativeDimmed（有关详细信息，请参阅 git-diff[1] 中 --color-moved 的 <mode> 设置）、contextDimmed、oldDimmed、newDimmed、contextBold、oldBold 和 newBold（有关详细信息，请参阅 git-range-diff[1]）之一。

为 git log --decorate 输出使用自定义颜色。<slot> 分别是 branch、remoteBranch、tag、stash 或 HEAD，用于本地分支、远程跟踪分支、标签、存储和 HEAD，以及 grafted 用于嫁接的提交。

当设置为always时，始终突出显示匹配项。当设置为false（或never）时，永不突出显示。当设置为true或auto时，仅在输出写入终端时才使用颜色。如果未设置，则使用color.ui的值（默认值为auto）。

使用自定义颜色进行 grep 着色。<slot> 指定要使用指定颜色的行的哪个部分，并且是以下之一：

当设置为always时，始终为交互式提示和显示使用颜色（例如“git-add --interactive”和“git-clean --interactive”使用的提示和显示）。当设置为false（或never）时，永不使用颜色。当设置为true或auto时，仅在输出到终端时才使用颜色。如果未设置，则使用color.ui的值（默认值为auto）。

为git add --interactive和git clean --interactive输出使用自定义颜色。<slot>可以是prompt、header、help或error，用于交互式命令的四种不同类型的普通输出。

一个布尔值，用于指定auto颜色模式是否应为发送到分页器的输出着色。默认为true；如果您的分页器不理解ANSI颜色代码，请将其设置为false。

一个布尔值，用于启用/禁用推送错误中的颜色。可以设置为always、false（或never）或auto（或true），在这种情况下，仅当错误输出发送到终端时才使用颜色。如果未设置，则使用color.ui的值（默认值为auto）。

为推送错误使用自定义颜色。

如果设置，则突出显示行开头的关键字。关键字为“error”、“warning”、“hint”和“success”，并且不区分大小写进行匹配。可以设置为always、false（或never）或auto（或true）。如果未设置，则使用color.ui的值（默认值为auto）。

为每个远程关键字使用自定义颜色。<slot>可以是hint、warning、success或error，它们与相应的关键字匹配。

一个布尔值，用于启用/禁用git-show-branch[1]输出中的颜色。可以设置为always、false（或never）或auto（或true），在这种情况下，仅当输出到终端时才使用颜色。如果未设置，则使用color.ui的值（默认值为auto）。

一个布尔值，用于启用/禁用git-status[1]输出中的颜色。可以设置为always、false（或never）或auto（或true），在这种情况下，仅当输出到终端时才使用颜色。如果未设置，则使用color.ui的值（默认值为auto）。

使用自定义颜色进行状态着色。<slot>可以是header（状态消息的标题文本）、added或updated（已添加但未提交的文件）、changed（已更改但未添加到索引中的文件）、untracked（Git 未跟踪的文件）、branch（当前分支）、nobranch（显示“no branch”警告的颜色，默认为红色）、localBranch或remoteBranch（分别为本地和远程分支名称，当在状态简短格式中显示分支和跟踪信息时）或unmerged（具有未合并更改的文件）。

一个布尔值，用于启用/禁用推送被拒绝时的颜色。可以设置为always、false（或never）或auto（或true），在这种情况下，仅当错误输出发送到终端时才使用颜色。如果未设置，则使用color.ui的值（默认值为auto）。

推送被拒绝时使用自定义颜色。

此变量确定诸如color.diff和color.grep等变量的默认值，这些变量控制每个命令族的颜色使用情况。随着更多命令学习配置以设置--color选项的默认值，其作用域将扩大。如果希望 Git 命令在未通过其他配置或--color选项明确启用时不使用颜色，请将其设置为false或never。如果希望所有不打算供机器使用的输出都使用颜色，请将其设置为always；如果希望此类输出在写入终端时使用颜色，请将其设置为true或auto（这是 Git 1.8.4 之后的默认值）。

指定支持的命令是否应以列的形式输出。此变量由以空格或逗号分隔的标记列表组成

指定是否以列的形式输出git branch中的分支列表。有关详细信息，请参阅column.ui。

指定在git clean -i中列出项目时的布局，它始终以列的形式显示文件和目录。有关详细信息，请参阅column.ui。

指定是否以列的形式输出git status中的未跟踪文件。有关详细信息，请参阅column.ui。

指定是否以列的形式输出git tag中的标签列表。有关详细信息，请参阅column.ui。

此设置会覆盖git commit中--cleanup选项的默认值。有关详细信息，请参阅git-commit[1]。当您始终希望在日志消息中保留以注释字符#开头的行时，更改默认值会很有用，在这种情况下，您将执行git config commit.cleanup whitespace（请注意，如果您这样做，则必须自己删除提交日志模板中以#开头的帮助行）。

一个布尔值，用于指定是否应对所有提交进行GPG签名。在执行诸如rebase之类的操作时使用此选项可能会导致大量提交被签名。使用代理来避免多次输入您的GPG密码可能会很方便。

一个布尔值，用于启用/禁用在使用编辑器准备提交消息时在提交消息模板中包含状态信息。默认为true。

指定用作新提交消息模板的文件的路径名。

一个布尔值或整数，用于指定git commit的详细程度。请参阅git-commit[1]。

指定在写入或读取commit-graph文件时要使用的生成号版本类型。如果指定版本1，则不会写入或读取已更正的提交日期。默认为2。

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

已弃用。如果为真，则等效于commitGraph.changedPathsVersion=-1，如果为假，则等效于commitGraph.changedPathsVersion=0。（如果也设置了commitGraph.changedPathVersion，则commitGraph.changedPathsVersion优先。）

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

这仅由git-completion.bash用于向已完成命令列表中添加或删除命令。通常，只有瓷器命令和一些其他选定的命令会被完成。您可以在此变量中添加更多命令，命令之间用空格分隔。在命令前加上-将从现有列表中删除它。

告诉Git是否要遵守工作树中文件的可执行位。

(仅限Windows) 如果为真，则将名称以点开头的最新创建的目录和文件标记为隐藏。如果为dotGitOnly，则仅隐藏.git/目录，而不隐藏其他以点开头的文件。默认模式为dotGitOnly。

内部变量，用于启用各种解决方法，使Git能够在不区分大小写的文件系统（如APFS、HFS+、FAT、NTFS等）上更好地工作。例如，如果目录列表在Git期望“Makefile”时找到“makefile”，Git将假设它实际上是同一个文件，并继续将其记住为“Makefile”。

此选项仅由Mac OS实现的Git使用。当core.precomposeUnicode=true时，Git会恢复Mac OS执行的文件名Unicode分解。这在Mac OS和Linux或Windows之间共享存储库时很有用。（需要Git for Windows 1.7.10或更高版本，或Cygwin 1.7下的Git）。当为false时，文件名由Git完全透明地处理，这与旧版Git向后兼容。

如果设置为true，则不允许检出在HFS+文件系统上被认为等效于.git的路径。在Mac OS上默认为true，在其他地方默认为false。

如果设置为true，则不允许检出会导致NTFS文件系统出现问题的路径，例如与8.3“短”名称冲突。在Windows上默认为true，在其他地方默认为false。

如果设置为true，则为该工作目录启用内置文件系统监视器守护程序（git-fsmonitor--daemon[1]）。

Otherwise, this variable contains the pathname of the "fsmonitor"
hook command.

设置调用“fsmonitor”钩子时要使用的协议版本。

如果为false，则忽略索引和工作树之间的ctime差异；在inode更改时间被Git外部的东西（文件系统爬虫和某些备份系统）定期修改时很有用。参见git-update-index[1]。默认为true。

如果为true，将使用索引的split-index功能。参见git-update-index[1]。默认为false。

确定如何处理索引的未跟踪缓存功能。如果此变量未设置或设置为keep，则将保留它。如果设置为true，则将自动添加它。如果设置为false，则将自动删除它。在将其设置为true之前，您应该检查mtime是否在您的系统上正常工作。参见git-update-index[1]。默认为keep，除非启用了feature.manyFiles，这会将此设置默认为true。

当缺少或设置为default时，将检查stat结构中的许多字段以检测文件自Git上次查看它以来是否已被修改。当此配置变量设置为minimal时，mtime和ctime的亚秒部分、文件所有者的uid和gid、inode编号（以及设备编号，如果Git已编译为使用它），将从这些字段的检查中排除，仅保留mtime（以及ctime，如果设置了core.trustCtime）的全秒部分和文件大小进行检查。

输出路径的命令（例如ls-files、diff）将通过将路径名括在双引号中并将这些字符用反斜杠转义来引用路径名中的“不寻常”字符，其方式与C转义控制字符（例如\t用于TAB，\n用于LF，\\用于反斜杠）或值大于0x80的字节（例如UTF-8中的“micro”的八进制\302\265）相同。如果此变量设置为false，则大于0x80的字节不再被视为“不寻常”。双引号、反斜杠和控制字符始终会被转义，而不管此变量的设置如何。简单的空格字符不被视为“不寻常”。许多命令可以使用-z选项完全逐字输出路径名。默认值为true。

设置工作目录中标记为文本的文件（通过设置text属性或通过设置text=auto并由Git自动检测内容为文本）要使用的行结束类型。备选方案为lf、crlf和native，后者使用平台的本机行结束符。默认值为native。有关行结束符转换的更多信息，请参见gitattributes[5]。请注意，如果core.autocrlf设置为true或input，则忽略此值。

如果为true，则使Git在行结束符转换处于活动状态时检查CRLF转换是否可逆。Git将验证命令是否直接或间接修改了工作树中的文件。例如，提交文件后检出同一个文件应该会在工作树中生成原始文件。如果对于core.autocrlf的当前设置并非如此，Git将拒绝该文件。该变量可以设置为“warn”，在这种情况下，Git只会警告不可逆转换，但会继续操作。

将此变量设置为 "true" 等同于将所有文件的 text 属性设置为 "auto" 以及将 core.eol 设置为 "crlf"。如果您希望在工作目录中使用 CRLF 换行符，并且存储库使用 LF 换行符，则将其设置为 true。此变量可以设置为 input，在这种情况下，不会执行输出转换。

一个用逗号和/或空格分隔的编码列表，如果这些编码在 working-tree-encoding 属性中使用（参见 gitattributes[5]），Git 将对其执行 UTF-8 往返检查。默认值为 SHIFT-JIS。

如果为 false，则符号链接将被检出为包含链接文本的小型纯文本文件。 git-update-index[1] 和 git-add[1] 不会将记录的类型更改为常规文件。在不支持符号链接的文件系统（如 FAT）上很有用。

一个“代理命令”，用于在使用 Git 协议获取时执行（作为 command host port），而不是建立到远程服务器的直接连接。如果变量值采用“COMMAND for DOMAIN”格式，则该命令仅应用于以指定域名字符串结尾的主机名。此变量可以设置多次，并按给定顺序匹配；第一个匹配项优先。

如果设置了此变量，则 git fetch 和 git push 在需要连接到远程系统时将使用指定的命令而不是 ssh。该命令的格式与 GIT_SSH_COMMAND 环境变量相同，并且在设置环境变量时会被覆盖。

如果为 true，Git 将避免使用 lstat() 调用来检测文件是否已更改，方法是为那些在索引和工作树中都以相同方式更新的已跟踪文件设置“assume-unchanged”位。

使用符号链接代替 HEAD 和其他符号引用文件的默认“symref”格式。有时需要与期望 HEAD 为符号链接的旧脚本一起使用。

在从备用存储库发布可用历史记录的提示时，使用 shell 执行指定的命令，而不是 git-for-each-ref[1]。第一个参数是备用存储库的绝对路径。输出必须包含每行一个十六进制对象 ID（即，与 git for-each-ref --format='%(objectname)' 生成的相同）。

在列出备用存储库中的引用时，仅列出以给定前缀开头的引用。前缀的匹配方式如同将其作为参数传递给 git-for-each-ref[1]。要列出多个前缀，请用空格分隔它们。如果设置了 core.alternateRefsCommand，则设置 core.alternateRefsPrefixes 将不起作用。

如果为 true，则假定此存储库为 裸存储库，并且没有与其关联的工作目录。如果是这种情况，则一些需要工作目录的命令将被禁用，例如 git-add[1] 或 git-merge[1]。

设置工作树根目录的路径。如果设置了 GIT_COMMON_DIR 环境变量，则忽略 core.worktree，并且不将其用于确定工作树的根目录。这可以被 GIT_WORK_TREE 环境变量和 --work-tree 命令行选项覆盖。该值可以是绝对路径，也可以相对于 .git 目录的路径，该路径由 --git-dir 或 GIT_DIR 指定，或者自动发现。如果指定了 --git-dir 或 GIT_DIR，但未指定 --work-tree、GIT_WORK_TREE 和 core.worktree，则当前工作目录被视为工作树的顶层。

启用 reflog。对 ref <ref> 的更新将记录到文件“$GIT_DIR/logs/<ref>”中，方法是追加新的和旧的 SHA-1、日期/时间和更新原因，但仅当文件存在时才执行此操作。如果将此配置变量设置为 true，则会为分支头（即 refs/heads/ 下）、远程引用（即 refs/remotes/ 下）、注释引用（即 refs/notes/ 下）和符号引用 HEAD 自动创建缺少的“$GIT_DIR/logs/<ref>”文件。如果将其设置为 always，则会为 refs/ 下的任何引用自动创建缺少的 reflog。

用于标识存储库格式和布局版本的内部变量。

当为 group（或 true）时，存储库将对组中的多个用户共享（确保所有文件和对象都是组可写的）。当为 all（或 world 或 everybody）时，存储库将可供所有用户读取，此外还可以与组共享。当为 umask（或 false）时，Git 将使用 umask(2) 报告的权限。当为 0xxx 时，其中 0xxx 是一个八进制数，存储库中的文件将具有此模式值。0xxx 将覆盖用户的 umask 值（而其他选项只会覆盖用户 umask 值的请求部分）。例如：0660 将使存储库对所有者和组可读/可写，但对其他人不可访问（等效于 group，除非 umask 为例如 0022）。0640 是一个组可读但不可组写的存储库。参见 git-init[1]。默认情况下为 false。

如果为 true，Git 将在您传递的 ref 名称不明确并且可能与存储库中的多个 ref 匹配时发出警告。默认为 true。

一个整数 -1..9，表示默认压缩级别。-1 是 zlib 的默认值。0 表示不压缩，1..9 是各种速度/大小权衡，9 最慢。如果设置，则为其他压缩变量（如 core.looseCompression 和 pack.compression）提供默认值。

一个整数 -1..9，表示不在打包文件中的对象的压缩级别。-1 是 zlib 的默认值。0 表示不压缩，1..9 是各种速度/大小权衡，9 最慢。如果未设置，则默认为 core.compression。如果未设置，则默认为 1（最佳速度）。

一次映射操作中，将打包文件多少字节映射到内存中。更大的窗口大小可以让您的系统更快地处理少量大型打包文件。较小的窗口大小会由于增加了对操作系统内存管理器的调用而导致性能下降，但在访问大量大型打包文件时可能会提高性能。

从打包文件中同时映射到内存中的最大字节数。如果 Git 需要一次访问超过这么多字节才能完成操作，它将取消映射现有区域以在进程中回收虚拟地址空间。

每个线程为缓存可能被多个增量对象引用的基本对象保留的最大字节数。通过将整个解压缩的基本对象存储在缓存中，Git 能够避免多次解压缩和解压缩常用基本对象。

被认为是“大”文件的尺寸，如下所述，它会改变许多 git 命令的行为，以及这些文件在存储库中的存储方式。默认为 512 MiB。支持常见的单位后缀 k、m 或 g。

指定包含用于描述不应跟踪的路径的模式的文件的路径名，此外还有 .gitignore（每个目录）和 .git/info/exclude。默认为 $XDG_CONFIG_HOME/git/ignore。如果 $XDG_CONFIG_HOME 未设置或为空，则改为使用 $HOME/.config/git/ignore。请参阅 gitignore[5]。

某些交互式请求密码的命令（例如 svn 和 http 接口）可以被告知使用通过此变量的值给出的外部程序。可以由 GIT_ASKPASS 环境变量覆盖。如果未设置，则回退到 SSH_ASKPASS 环境变量的值，或者如果失败，则回退到简单的密码提示。外部程序应获得合适的提示作为命令行参数，并在其 STDOUT 上写入密码。

除了 .gitattributes（每个目录）和 .git/info/attributes 之外，Git 还查看此文件以获取属性（请参阅 gitattributes[5]）。路径扩展的方式与 core.excludesFile 相同。其默认值为 $XDG_CONFIG_HOME/git/attributes。如果 $XDG_CONFIG_HOME 未设置或为空，则改为使用 $HOME/.config/git/attributes。

默认情况下，Git 将在 $GIT_DIR/hooks 目录中查找您的钩子。将其设置为不同的路径，例如 /etc/git/hooks，Git 将尝试在该目录中查找您的钩子，例如 /etc/git/hooks/pre-receive 而不是 $GIT_DIR/hooks/pre-receive。

诸如 commit 和 tag 之类的命令允许您通过启动编辑器来编辑消息，当设置此变量且未设置环境变量 GIT_EDITOR 时，它们会使用此变量的值。请参阅 git-var[1]。

诸如 commit 和 tag 之类的命令允许您编辑消息，它们会将以该字符开头的行视为注释，并在编辑器返回后将其删除（默认为 #）。

[core]
# single character for older versions
commentChar = "#"
# string for newer versions (which will override commentChar
# because it comes later in the file)
commentString = "//"

尝试锁定单个引用时重试的时间长度（以毫秒为单位）。值为 0 表示根本不重试；-1 表示无限期重试。默认为 100（即重试 100 毫秒）。

尝试锁定 packed-refs 文件时重试的时间长度（以毫秒为单位）。值为 0 表示根本不重试；-1 表示无限期重试。默认为 1000（即重试 1 秒）。

Git 命令使用的文本查看器（例如，less）。该值旨在由 shell 解释。优先顺序为 $GIT_PAGER 环境变量、然后是 core.pager 配置、然后是 $PAGER，最后是编译时选择的默认值（通常为 less）。

一个以逗号分隔的常见空白问题列表，需要注意。git diff 将使用 color.diff.whitespace 来突出显示它们，并且 git apply --whitespace=error 将它们视为错误。您可以添加前缀 - 来禁用其中的任何一个（例如 -trailing-space）

在创建或修改存储库时，应通过 core.fsyncMethod 加固的存储库组件的逗号分隔列表。您可以通过在组件前添加-来禁用任何组件的加固。在系统非正常关闭的情况下，未加固的项目可能会丢失。除非您有特殊要求，否则建议您将此选项留空或选择committed、added或all之一。

指示 Git 将使用哪种策略使用 fsync 和相关原语来加固存储库数据的值。

此布尔值将在写入对象文件时启用fsync()。此设置已弃用。请使用 core.fsync 代替。

为git diff等操作启用并行索引预加载

仅限 Windows：需要在生成任何其他进程之前取消设置的环境变量名称的逗号分隔列表。默认为PERL5LIB，以解决 Git for Windows 坚持使用其自己的 Perl 解释器这一事实。

仅限 Windows：覆盖生成的进程是否仅继承标准文件句柄（stdin、stdout和stderr）或所有句柄。可以是auto、true或false。默认为auto，这意味着在 Windows 7 及更高版本上为true，在较旧的 Windows 版本上为false。

您可以将其设置为link，在这种情况下，将使用硬链接，然后删除源文件，以确保对象创建不会覆盖现有对象。

显示提交消息时，还显示存储在给定引用中的注释。引用必须是完全限定的。如果给定引用不存在，则不会出错，但表示不应打印任何注释。

如果为 true，则 git 将读取提交图文件（如果存在）以解析提交的图结构。默认为 true。有关更多信息，请参阅git-commit-graph[1]。

如果设置为false，则行为如同在命令行上给出了--no-replace-objects选项一样。有关更多信息，请参阅git[1]和git-replace[1]。

使用多包索引文件使用单个索引跟踪多个包文件。有关更多信息，请参阅git-multi-pack-index[1]。默认为 true。

启用“稀疏检出”功能。有关更多信息，请参阅git-sparse-checkout[1]。

启用稀疏检出功能的“锥形模式”。当稀疏检出文件包含一组有限的模式时，此模式提供了显着的性能优势。可以通过将此变量设置为false来请求“非锥形模式”以允许指定更灵活的模式。有关更多信息，请参阅git-sparse-checkout[1]。

设置对象名称缩写到的长度。如果未指定或设置为“auto”，则将根据存储库中打包对象的近似数量计算适当的值，这希望足以使缩写对象名称在一段时间内保持唯一。如果设置为“no”，则不会进行缩写，并且对象名称将以其完整长度显示。最小长度为 4。

Git 遍历树时愿意递归的最大深度（例如，“a/b/cde/f”的深度为 4）。这是一个故障安全机制，允许 Git 清洁地中止，通常不需要调整。当 Git 使用 MSVC 编译时，默认为 512。否则，默认为 2048。

指定需要用户名或密码凭据时要调用的外部帮助程序；帮助程序可能会咨询外部存储以避免提示用户输入凭据。这通常是凭据帮助程序的名称以及可能的参数，但也可能是带有参数的绝对路径，或者如果以!开头，则是 shell 命令。

默认情况下，Git 和任何配置的凭据帮助程序在需要新凭据时都会要求用户输入。如果这些凭据仍然有效，则许多这些帮助程序将根据存储的凭据成功。要避免 Git 的用户交互可能性，请设置credential.interactive=false。一些凭据帮助程序也尊重此选项。

获取凭据时，将 http 或 https URL 的“路径”组件视为重要。默认为 false。有关更多信息，请参阅gitcredentials[7]。

如果未为网络身份验证设置用户名，则默认使用此用户名。请参阅下面的 credential.<context>.* 和gitcredentials[7]。

上述任何 credential.* 选项都可以选择性地应用于某些凭据。例如，“credential.https://example.com.username”将仅为与 example.com 的 https 连接设置默认用户名。有关如何匹配 URL 的详细信息，请参阅gitcredentials[7]。

告诉 git-credential-cache—​daemon 忽略 SIGHUP，而不是退出。

git-credential-store 在尝试锁定凭据文件时重试的时间长度（以毫秒为单位）。值为 0 表示根本不重试；-1 表示无限期重试。默认为 1000（即重试 1 秒）。

当使用git diff与工作树文件进行比较时，不要将仅状态更改视为已更改。而是静默运行git update-index --refresh以更新工作树中内容与索引中内容匹配的路径的缓存状态信息。此选项默认为 true。请注意，这仅影响git diff Porcelain，而不影响较低级别的diff命令，例如git diff-files。

一个用逗号分隔的--dirstat参数列表，用于指定--dirstat选项对git-diff[1]及其相关命令的默认行为。这些默认值可以在命令行中被覆盖（使用--dirstat=<param1,param2,...>）。回退默认值（当未被diff.dirstat修改时）为changes,noncumulative,3。以下参数可用：

限制--stat输出中文件名部分的宽度。如果设置，则应用于所有生成--stat输出的命令，除了format-patch。

限制--stat输出中图形部分的宽度。如果设置，则应用于所有生成--stat输出的命令，除了format-patch。

生成具有<n>行上下文而不是默认的3行的diff。此值会被-U选项覆盖。

显示diff块之间的上下文，最多指定行数，从而融合彼此靠近的块。此值用作--inter-hunk-context命令行选项的默认值。

如果设置了此配置变量，则diff生成不会使用内部diff机制，而是使用给定的命令。可以通过‘GIT_EXTERNAL_DIFF’环境变量覆盖。该命令的参数调用方式如git[1]中“git Diffs”部分所述。注意：如果您只想对部分文件使用外部diff程序，则可能需要改为使用gitattributes[5]。

如果此布尔值设置为true，则预期diff.external命令在认为输入文件相等时返回退出代码0，在认为它们不同时返回1，就像diff(1)一样。如果将其设置为false（默认值），则无论是否相等，都预期命令返回退出代码0。任何其他退出代码都会导致Git报告致命错误。

设置--ignore-submodules的默认值。请注意，这仅影响git diff Porcelain，而不影响较低级别的diff命令，如git diff-files。git checkout和git switch在报告未提交的更改时也会遵循此设置。将其设置为all将禁用git commit和git status在status.submoduleSummary设置时通常显示的子模块摘要，除非使用--ignore-submodules命令行选项覆盖它。git submodule命令不受此设置影响。默认情况下，此设置为untracked，以便忽略任何未跟踪的子模块。

如果设置，git diff将使用与标准“a/”和“b/”不同的前缀对，具体取决于比较的内容。当此配置生效时，反向diff输出也会交换前缀的顺序。

如果设置，git diff不会显示任何源或目标前缀。

如果设置，git diff将使用此源前缀。默认为“a/”。

如果设置，git diff将使用此目标前缀。默认为“b/”。

如果设置为true，git diff不会显示目录之外的更改，并显示相对于当前目录的路径名。

指示如何在diff中排序文件的文件。有关详细信息，请参阅git-diff[1]的-O选项。如果diff.orderFile是相对路径名，则将其视为相对于工作树的顶部。

在复制/重命名检测的详尽部分中要考虑的文件数量；等效于git diff选项-l。如果未设置，则当前默认值为1000。如果关闭重命名检测，则此设置无效。

Git是否以及如何检测重命名。如果设置为“false”，则禁用重命名检测。如果设置为“true”，则启用基本重命名检测。如果设置为“copies”或“copy”，Git也将检测复制。默认为true。请注意，这仅影响像git-diff[1]和git-log[1]这样的git diff Porcelain，而不影响较低级别的命令，如git-diff-files[1]。

一个布尔值，用于抑制打印每个空输出行之前的空格的标准行为。默认为false。

指定显示子模块差异的格式。“short”格式仅显示范围开头和结尾处的提交名称。“log”格式列出范围内的提交，就像git-submodule[1] summary一样。“diff”格式显示子模块更改内容的内联diff。默认为“short”。

一个POSIX扩展正则表达式，用于在执行逐词差异计算时确定什么是“词”。与正则表达式匹配的字符序列是“词”，所有其他字符都是可忽略的空格。

自定义diff驱动程序命令。有关详细信息，请参阅gitattributes[5]。

如果此布尔值设置为true，则预期diff.<driver>.command命令在认为输入文件相等时返回退出代码0，在认为它们不同时返回1，就像diff(1)一样。如果将其设置为false（默认值），则无论是否相等，都预期命令返回退出代码0。任何其他退出代码都会导致Git报告致命错误。

diff驱动程序应用于识别块头的正则表达式。也可以使用内置模式。有关详细信息，请参阅gitattributes[5]。

将此选项设置为true，以使diff驱动程序将文件视为二进制文件。有关详细信息，请参阅gitattributes[5]。

diff驱动程序应调用的命令，用于生成文件的文本转换版本。转换结果用于生成人类可读的diff。有关详细信息，请参阅gitattributes[5]。

diff驱动程序应用于拆分行中单词的正则表达式。有关详细信息，请参阅gitattributes[5]。

将此选项设置为true，以使diff驱动程序缓存文本转换输出。有关详细信息，请参阅gitattributes[5]。

将此选项设置为false以禁用默认启发式算法，该算法会移动 diff 片段边界以使补丁更易于阅读。

选择一个 diff 算法。变体如下所示

突出显示 diff 中context、old或new行的空白错误。多个值用逗号分隔，none重置先前值，default将列表重置为new，而all是old,new,context的简写。空白错误用color.diff.whitespace着色。命令行选项--ws-error-highlight=<kind>会覆盖此设置。

如果设置为有效<mode>或真值，则 diff 中移动的行将以不同的颜色显示，有关有效模式的详细信息，请参阅git-diff[1]中的--color-moved。如果仅设置为 true，则将使用默认颜色模式。设置为 false 时，移动的行不会着色。

当使用例如diff.colorMoved设置对移动的行进行着色时，此选项控制如何处理空格的<mode>。有关有效模式的详细信息，请参阅git-diff[1]中的--color-moved-ws。

控制git-difftool[1]使用的 diff 工具。此变量会覆盖在merge.tool中配置的值。以下列表显示了有效的内置值。任何其他值都被视为自定义 diff 工具，并且需要定义相应的difftool.<tool>.cmd变量。

当指定-g/--gui标志时，控制git-difftool[1]使用的 diff 工具。此变量会覆盖在merge.guitool中配置的值。以下列表显示了有效的内置值。任何其他值都被视为自定义 diff 工具，并且需要定义相应的difftool.<guitool>.cmd变量。

指定用于调用指定 diff 工具的命令。指定的命令在 shell 中执行，并提供以下变量：LOCAL设置为包含 diff 前映像内容的临时文件的名称，REMOTE设置为包含 diff 后映像内容的临时文件的名称。

覆盖给定工具的路径。如果您的工具不在 PATH 中，这将很有用。

如果调用的 diff 工具返回非零退出状态，则退出 difftool。

在每次调用 diff 工具之前提示。

设置为true以默认使用diff.guitool（相当于指定--gui参数），或设置为auto以根据DISPLAY环境变量值的存在选择diff.guitool或diff.tool。默认为false，其中必须明确提供--gui参数才能使用diff.guitool。

指定要使用的哈希算法。可接受的值为sha1和sha256。如果未指定，则假定为sha1。除非core.repositoryFormatVersion为 1，否则指定此键是错误的。

指定要使用的兼容性哈希算法。可接受的值为sha1和sha256。指定的值必须不同于extensions.objectFormat的值。这允许在objectFormat与该compatObjectFormat匹配的git存储库之间进行客户端级别的互操作性。特别是当完全实现时，来自objectFormat与compatObjectFormat匹配的存储库的推送和拉取。以及能够使用compatObjectFormat中编码的oids以及使用objectFormat编码的oids来本地指定对象。

指定要使用的 ref 存储格式。可接受的值为

如果启用，则工作树除了加载$GIT_COMMON_DIR/config文件之外，还会加载$GIT_DIR/config.worktree文件中的配置设置。请注意，对于主工作树，$GIT_COMMON_DIR和$GIT_DIR相同，而其他工作树的$GIT_DIR等于$GIT_COMMON_DIR/worktrees/<id>/。config.worktree文件中的设置将覆盖任何其他配置文件中的设置。

如果git-fast-import[1]导入的对象数量低于此限制，则这些对象将解压到松散的对象文件中。但是，如果导入的对象数量等于或超过此限制，则包将存储为包。从快速导入存储包可以使导入操作更快地完成，尤其是在速度较慢的文件系统上。如果未设置，则使用transfer.unpackLimit的值。

以feature.开头的配置设置会修改一组其他配置设置的默认值。这些组由 Git 开发者社区创建作为推荐的默认值，并且可能会发生变化。特别是，可能会添加新的配置选项，并具有不同的默认值。

启用 Git 中的新配置选项，并且正在考虑将其作为未来的默认值。此处包含的配置设置可能会在每个版本（包括次要版本更新）中添加或删除。由于这些设置非常新，因此它们可能存在意外的交互。如果您有兴趣提供有关实验性功能的反馈，请启用此设置。新的默认值为

启用针对工作目录中包含许多文件的存储库进行优化的配置选项。对于许多文件，诸如git status和git checkout之类的命令可能会很慢，这些新的默认值可以提高性能

此选项控制git fetch（以及git pull中的底层获取）是否会递归地获取到填充的子模块中。此选项可以设置为布尔值或on-demand。将其设置为布尔值会更改 fetch 和 pull 的行为，以便在设置为 true 时无条件地递归到子模块中，或者在设置为 false 时根本不递归。设置为on-demand时，fetch 和 pull 仅在超级项目检索更新子模块引用的提交时才会递归到填充的子模块中。默认为on-demand，或者如果设置了submodule.recurse，则默认为该值。

如果将其设置为 true，则 git-fetch-pack 将检查所有获取的对象。有关检查的内容，请参阅transfer.fsckObjects。默认为 false。如果未设置，则使用transfer.fsckObjects的值。

类似于fsck.<msg-id>，但由git-fetch-pack[1]而不是git-fsck[1]使用。有关详细信息，请参阅fsck.<msg-id>文档。

类似于fsck.skipList，但由git-fetch-pack[1]而不是git-fsck[1]使用。有关详细信息，请参阅fsck.skipList文档。

如果通过 Git 原生传输获取的对象数量低于此限制，则这些对象将解压到松散的对象文件中。但是，如果接收到的对象数量等于或超过此限制，则接收到的包将在添加任何缺失的 delta 基数后存储为包。从推送中存储包可以使推送操作更快完成，尤其是在文件系统速度较慢的情况下。如果未设置，则使用 transfer.unpackLimit 的值。

如果为真，则 fetch 将自动表现得好像在命令行上给出了 --prune 选项。另请参阅 remote.<name>.prune 和 git-fetch[1] 的 PRUNING 部分。

如果为真，则 fetch 将自动表现得好像在修剪时提供了 refs/tags/*:refs/tags/* refspec（如果尚未设置）。这允许同时设置此选项和 fetch.prune 以维护与上游 ref 的 1=1 映射。另请参阅 remote.<name>.pruneTags 和 git-fetch[1] 的 PRUNING 部分。

如果为真，则 fetch 将尝试更新所有可用的远程仓库。可以通过传递 --no-all 或显式指定要从中获取的一个或多个远程仓库来覆盖此行为。默认为 false。

控制如何打印 ref 更新状态。有效值为 full 和 compact。默认值为 full。有关详细信息，请参阅 git-fetch[1] 中的 OUTPUT 部分。

控制在协商服务器要发送的包文件内容时如何发送本地存储库中提交的信息。设置为 "consecutive" 以使用一种算法，该算法遍历连续的提交并检查每一个提交。设置为 "skipping" 以使用一种算法，该算法跳过提交以加快收敛速度，但可能导致包文件比必要的大；或者设置为 "noop" 以根本不发送任何信息，这几乎肯定会导致包文件比必要的大，但会跳过协商步骤。设置为 "default" 以覆盖之前做出的设置并使用默认行为。默认值通常为 "consecutive"，但如果 feature.experimental 为 true，则默认值为 "skipping"。未知值会导致 git fetch 发生错误。

设置为 false 以在 git-fetch[1] 和 git-pull[1] 命令中启用 --no-show-forced-updates。默认为 true。

指定同时并行运行的最大 fetch 操作数（子模块，或在 git-fetch[1] 的 --multiple 选项生效时使用的远程仓库）。

设置为 true 以在每个从远程下载包文件的 git fetch 命令之后写入提交图。使用 --split 选项，大多数执行将在现有提交图文件之上创建非常小的提交图文件。偶尔，这些文件会合并，并且写入可能需要更长时间。拥有更新的提交图文件有助于提高许多 Git 命令的性能，包括 git merge-base、git push -f 和 git log --graph。默认为 false。

此值存储一个 URI，用于在从原始 Git 服务器执行增量获取之前从捆绑包 URI 下载 Git 对象数据。这类似于 git-clone[1] 中 --bundle-uri 选项的行为。如果提供的捆绑包 URI 包含为增量获取组织的捆绑包列表，则 git clone --bundle-uri 将设置 fetch.bundleURI 值。

当使用 fetch.bundleURI 从使用“creationToken”启发式的捆绑包列表增量获取时，此配置值存储已下载捆绑包的最大 creationToken 值。如果广告的 creationToken 不严格大于此值，则此值用于将来防止下载捆绑包。

用于在签入时将工作树文件的內容转换为 blob 的命令。有关详细信息，请参阅 gitattributes[5]。

用于在检出时将 blob 对象的內容转换为工作树文件的命令。有关详细信息，请参阅 gitattributes[5]。

启用 multipart/mixed 附件作为 format-patch 的默认值。该值也可以是双引号字符串，它将启用附件作为默认值并将该值设置为边界。请参阅 git-format-patch[1] 中的 --attach 选项。要抵消较早的值，请将其设置为空字符串。

提供 --from 选项到 format-patch 的默认值。接受布尔值或名称和电子邮件地址。如果为 false，则 format-patch 默认为 --no-from，在补丁邮件的“From:”字段中直接使用提交作者。如果为 true，则 format-patch 默认为 --from，在补丁邮件的“From:”字段中使用您的提交者身份并在补丁邮件正文中包含“From:”字段（如果不同）。如果设置为非布尔值，则 format-patch 使用该值而不是您的提交者身份。默认为 false。

提供 --[no-]force-in-body-from 选项到 format-patch 的默认值。默认为 false。

一个布尔值，可以启用或禁用补丁主题中的序列号。它默认为“auto”，仅在有多个补丁时启用。可以通过将其设置为“true”或“false”来为所有消息启用或禁用它。请参阅 git-format-patch[1] 中的 --numbered 选项。

要包含在要通过邮件提交的补丁中的其他电子邮件标头。请参阅 git-format-patch[1]。

要包含在要通过邮件提交的补丁中的其他收件人。请参阅 git-format-patch[1] 中的 --to 和 --cc 选项。

format-patch 的默认行为是输出带有 [PATCH] 主题前缀的文件。使用此变量更改该前缀。

format-patch 确定将使用分支描述填充介绍信的哪些部分的默认模式。请参阅 git-format-patch[1] 中的 --cover-from-description 选项。

format-patch 的默认行为是输出包含 Git 版本号的签名。使用此变量更改该默认值。将此变量设置为空字符串 ("") 以抑制签名生成。

与 format.signature 的工作方式相同，只是此变量指定的文件的內容将用作签名。

format-patch 的默认行为是输出后缀为 .patch 的文件。使用此变量更改该后缀（如果需要，请确保包含点）。

使用“Q-编码”（RFC 2047 中描述）对具有非 ASCII 字符的电子邮件标头进行编码以进行电子邮件传输。默认为 true。

log/show/whatchanged 命令的默认漂亮格式。请参阅 git-log[1]、git-show[1]、git-whatchanged[1]。

git format-patch 的默认线程样式。可以是布尔值，也可以是 shallow 或 deep。shallow 线程使每封邮件都回复到系列的头部，其中头部是从介绍信、--in-reply-to 和第一封补丁邮件中选择的，按此顺序。deep 线程使每封邮件都回复到前一封邮件。布尔值 true 与 shallow 相同，布尔值 false 禁用线程。

一个布尔值，允许您默认启用 format-patch 的 -s/--signoff 选项。**注意：**将 Signed-off-by 尾部添加到补丁应该是深思熟虑的行为，这意味着您证明您有权在相同的开源许可下提交此工作。请参阅 SubmittingPatches 文档以获取进一步讨论。

一个布尔值，控制在调用 format-patch 时是否生成介绍信，但此外可以设置为“auto”，仅当有多个补丁时才生成介绍信。默认为 false。

设置一个自定义目录来存储结果文件，而不是当前工作目录。将创建所有目录组件。

format-patch 命令生成的输出文件名的最大长度；默认为 64。可以通过 --filename-max-length=<n> 命令行选项覆盖。

一个布尔值，允许您默认启用 format-patch 的 --base=auto 选项。也可以设置为“whenAble”以允许启用 --base=auto（如果合适的基数可用），但在没有格式死亡的情况下跳过添加基数信息。

为format-patch的--notes选项提供默认值。接受布尔值或指定获取注释位置的引用。如果为false，则format-patch默认为--no-notes。如果为true，则format-patch默认为--notes。如果设置为非布尔值，则format-patch默认为--notes=<ref>，其中ref为非布尔值。默认为false。

[format]
	notes = true
	notes = foo
	notes = false
	notes = bar

一个布尔值，当使用--stdout转义"^>+From "行时，启用强大的“mboxrd”格式。

如果设置，则不在补丁中显示任何源或目标前缀。这等效于git diff使用的diff.noprefix选项（但format-patch不尊重该选项）。请注意，通过设置此选项，您生成的任何补丁的接收者都必须使用-p0选项应用它们。

在fsck过程中，git可能会发现旧版数据存在问题，这些问题不会由当前版本的git生成，并且如果设置了transfer.fsckObjects，则不会通过网络发送。此功能旨在支持使用包含此类数据的旧版存储库。

已知以非致命方式损坏且应忽略的对象名称列表的路径（即每行一个未缩写的SHA-1）。在Git 2.20及更高版本中，注释（#）、空行以及任何前导和尾随空格将被忽略。在旧版本中，每行除了SHA-1之外的所有内容都会出错。

默认情况下，fsmonitor守护程序拒绝与网络挂载的存储库一起工作。将fsmonitor.allowRemote设置为true将覆盖此行为。仅在core.fsmonitor设置为true时受尊重。

此Mac OS特定选项（如果设置）指定用于在fsmonitor守护程序和各种Git命令之间创建通信的Unix域套接字的目录。该目录必须位于本机Mac OS文件系统上。仅在core.fsmonitor设置为true时受尊重。

git gc --aggressive使用的增量压缩算法中使用的深度参数。默认为50，这是--aggressive未启用时--depth选项的默认值。

git gc --aggressive使用的增量压缩算法中使用的窗口大小参数。默认为250，这比默认的--window 10要激进得多。

当存储库中大约有超过此数量的松散对象时，git gc --auto将打包它们。一些瓷器命令使用此命令不时执行轻量级垃圾回收。默认值为6700。

当存储库中存在超过此数量的未标记为*.keep文件的包时，git gc --auto会将它们合并成一个更大的包。默认值为50。将其设置为0将禁用它。将gc.auto设置为0也将禁用此功能。

如果系统支持，则使git gc --auto立即返回并在后台运行。默认为true。如果未设置maintenance.autoDetach，则此配置变量充当后备。

如果非零，则运行git gc时，所有大于此限制的非废弃包都将保留。这与--keep-largest-pack非常相似，只是所有满足阈值的非废弃包都将保留，而不仅仅是最大的包。默认为零。支持k、m或g的常用单位后缀。

如果为true，则在运行git-gc[1]时，gc将重写commit-graph文件。当使用git gc --auto时，如果需要进行日常维护，则将更新commit-graph。默认为true。有关详细信息，请参阅git-commit-graph[1]。

如果文件gc.log存在，则git gc --auto将打印其内容并以状态零退出，而不是运行，除非该文件超过gc.logExpiry时间。默认为“1.day”。有关指定其值的更多方法，请参阅gc.pruneExpire。

在存储库中运行git pack-refs会使Git 1.5.1.2之前的版本无法通过HTTP等哑传输克隆它。此变量确定git gc是否运行git pack-refs。可以将其设置为notbare以在所有非裸存储库中启用它，也可以将其设置为布尔值。默认为true。

将不可达对象存储在废弃包中（请参阅git-repack[1]），而不是作为松散对象。默认为true。

限制重新打包时新废弃包的大小。当与--max-cruft-size一起指定时，命令行选项优先。请参阅git-repack[1]的--max-cruft-size选项。

当运行git gc时，它将调用prune --expire 2.weeks.ago（如果通过gc.cruftPacks或--cruft使用废弃包，则调用repack --cruft --cruft-expiration 2.weeks.ago）。使用此配置变量覆盖宽限期。“now”值可用于禁用此宽限期并始终立即修剪不可达对象，或使用“never”值来抑制修剪。此功能有助于防止git gc与另一个写入存储库的进程并发运行时出现损坏；请参阅git-gc[1]的“NOTES”部分。

当运行git gc时，它会调用git worktree prune --expire 3.months.ago。此配置变量可用于设置不同的宽限期。值“now”可用于禁用宽限期并立即修剪$GIT_DIR/worktrees，或使用“never”来抑制修剪。

git reflog expire 删除早于此时间之前的 reflog 条目；默认为 90 天。值“now”会立即过期所有条目，而“never”则完全抑制过期。在中间使用“<pattern>” (例如“refs/stash”) 时，设置仅适用于与 <pattern> 匹配的 refs。

git reflog expire 删除早于此时间且无法从当前顶端访问的 reflog 条目；默认为 30 天。值“now”会立即过期所有条目，而“never”则完全抑制过期。在中间使用“<pattern>” (例如“refs/stash”) 时，设置仅适用于与 <pattern> 匹配的 refs。

在考虑是否删除对象时（无论是在生成废弃包还是将无法访问的对象存储为松散对象时），都使用 shell 执行指定的命令。将它们的输出解释为 Git 将视为“最近”的对象 ID，无论其年龄如何。通过将它们的修改时间视为“now”，输出中提到的任何对象（及其后代）都将保留，无论其真实年龄如何。

重新打包时，使用指定的过滤器将某些对象移动到单独的包文件中。请参阅git-repack[1]的--filter=<filter-spec>选项。

重新打包并使用过滤器时，请参阅gc.repackFilter，指定的路径将用于创建包含已过滤对象的包文件。**警告：**指定的路径应该是可访问的，例如使用 Git 备用机制，否则 Git 可能会认为存储库已损坏，因为它可能无法访问该包文件中的对象。请参阅git-repack[1]的--filter-to=<dir>选项和gitrepository-layout[5]的objects/info/alternates部分。

当运行git rerere gc时，您之前解决的冲突合并记录将保留这么多天。您还可以使用更易于理解的“1.month.ago”等。默认值为 60 天。请参阅git-rerere[1]。

当运行git rerere gc时，您尚未解决的冲突合并记录将保留这么多天。您还可以使用更易于理解的“1.month.ago”等。默认值为 15 天。请参阅git-rerere[1]。

将此字符串附加到每个提交消息中。设置为空字符串以禁用此功能。默认为“via git-CVS emulator”。

此存储库是否启用了 CVS 服务器接口。请参阅git-cvsserver[1]。

CVS 服务器接口记录各种内容的日志文件的路径。请参阅git-cvsserver[1]。

如果为真，则服务器将查找文件的换行符转换属性以确定要使用的-k模式。如果属性强制 Git 将文件视为文本，则-k模式将留空，以便 CVS 客户端将其视为文本。如果它们抑制文本转换，则文件将设置为-kb模式，这将抑制客户端可能执行的任何换行符修改。如果属性不允许确定文件类型，则使用gitcvs.allBinary。请参阅gitattributes[5]。

如果gitcvs.usecrlfattr无法解析要使用的正确的-kb模式，则使用此模式。如果为真，则所有未解析的文件都将以-kb模式发送到客户端。这会导致客户端将它们视为二进制文件，从而抑制它可能执行的任何换行符修改。或者，如果将其设置为“guess”，则检查文件内容以确定它是否为二进制文件，类似于core.autocrlf。

git-cvsserver 用于缓存从 Git 存储库派生的修订版信息的数据库。确切的含义取决于使用的数据库驱动程序，对于 SQLite（默认驱动程序）来说，这是一个文件名。支持变量替换（有关详细信息，请参阅git-cvsserver[1]）。可能不包含分号（;）。默认值：%Ggitcvs.%m.sqlite

使用的 Perl DBI 驱动程序。您可以在此处为其指定任何可用的驱动程序，但它可能无法工作。git-cvsserver 已通过DBD::SQLite进行了测试，据报道可与DBD::Pg一起使用，并且据报道无法与DBD::mysql一起使用。实验性功能。可能不包含双冒号（:）。默认值：SQLite。请参阅git-cvsserver[1]。

数据库用户和密码。仅在设置gitcvs.dbDriver时才有用，因为 SQLite 没有数据库用户和/或密码的概念。gitcvs.dbUser支持变量替换（有关详细信息，请参阅git-cvsserver[1]）。

数据库表名前缀。添加到使用的任何数据库表名的名称之前，允许单个数据库用于多个存储库。支持变量替换（有关详细信息，请参阅git-cvsserver[1]）。任何非字母字符都将替换为下划线。

请参阅gitweb[1]以获取说明。

请参阅gitweb.conf[5]以获取说明。

在创建或验证 PGP 签名时，使用此自定义程序而不是$PATH上找到的“gpg”。该程序必须支持与 GPG 相同的命令行界面，即，要验证分离的签名，将运行“gpg --verify $signature - <$file”，并且程序预计会通过退出代码 0 来发出良好的签名信号。要生成 ASCII 编码的分离签名，将“gpg -bsau $key”的标准输入提供给要签名的内容，并且程序预计会将其结果发送到其标准输出。

指定使用--gpg-sign签名时要使用的密钥格式。默认为“openpgp”。其他可能的值为“x509”、“ssh”。

使用此功能自定义为您选择的签名格式使用的程序。（请参阅gpg.program和gpg.format）gpg.program仍可作为gpg.openpgp.program的传统同义词使用。gpg.x509.program的默认值为“gpgsm”，gpg.ssh.program的默认值为“ssh-keygen”。

指定签名验证的最低信任级别。如果未设置此选项，则合并操作的签名验证需要至少具有marginal信任的密钥。执行签名验证的其他操作需要至少具有undefined信任的密钥。设置此选项将覆盖所有操作所需的信任级别。支持的值，按重要性递增顺序

当 user.signingkey 未设置且请求 SSH 签名时，将运行此命令。成功退出后，预期其输出的第一行包含以 key:: 为前缀的有效 SSH 公钥。这允许脚本在静态配置 user.signingKey 不切实际时动态查找正确的公钥。例如，当密钥或 SSH 证书频繁轮换，或选择正确的密钥取决于 Git 未知的外部因素时。

包含您愿意信任的 SSH 公钥的文件。该文件由一个或多个主体行后跟一个 SSH 公钥组成。例如：[email protected],[email protected] ssh-rsa AAAAX1... 有关详细信息，请参阅 ssh-keygen(1) 的“ALLOWED SIGNERS”部分。主体仅用于识别密钥，并在验证签名时可用。

SSH KRL 或吊销的公钥列表（不带主体前缀）。有关详细信息，请参阅 ssh-keygen(1)。如果在此文件中找到公钥，则始终将其视为具有“never”信任级别，并且签名将显示为无效。

如果设置为 true，则默认启用 -n 选项。

如果设置为 true，则默认启用 --column 选项。

设置默认匹配行为。使用 basic、extended、fixed 或 perl 值将分别启用 --basic-regexp、--extended-regexp、--fixed-strings 或 --perl-regexp 选项，而 default 值将使用 grep.extendedRegexp 选项在 basic 和 extended 之间进行选择。

如果设置为 true，则默认启用 --extended-regexp 选项。当 grep.patternType 选项设置为除 default 以外的值时，此选项将被忽略。

要使用的 grep 工作线程数。如果未设置（或设置为 0），Git 将使用与可用逻辑核心数相同的线程数。

如果设置为 true，则默认启用 --full-name 选项。

如果设置为 true，则如果在 Git 存储库之外执行 git grep，则回退到 git grep --no-index。默认为 false。

定义 git-gui[1] 中提交消息窗口的宽度。“75”为默认值。

指定 git-gui[1] 在调用 diff 时应使用的上下文行数。默认为“5”。

确定 git-gui[1] 是否在文件列表中显示未跟踪的文件。默认为“true”。

指定在 git-gui[1] 和 gitk[1] 中显示文件内容时使用的默认字符编码。可以通过为相关文件设置 encoding 属性来覆盖它（请参阅 gitattributes[5]）。如果未设置此选项，则工具默认为区域设置编码。

确定使用 git-gui[1] 创建的新分支是否默认跟踪名称匹配的远程分支。默认值：“false”。

在使用 git-gui[1] 创建新分支时用作建议名称。

如果 git-gui[1] 在执行 fetch 时应修剪远程跟踪分支，则为“true”。默认值为“false”。

确定 git-gui[1] 是否应信任文件修改时间戳。默认情况下，不信任时间戳。

指定 git-gui[1] 中用于拼写检查提交消息的字典。当设置为“none”时，拼写检查将关闭。

如果为 true，则 git gui blame 使用 -C 而不是 -C -C 来检测原始位置。这使得 blame 在大型存储库上的速度显著提高，但代价是复制检测不那么彻底。

指定在 git gui blame 原始位置检测中使用的阈值，以字母数字字符为单位。有关复制检测的更多信息，请参阅 git-blame[1] 手册。

指定在从 git gui blame 调用“显示历史上下文”菜单项时，在 gitk[1] 中显示所选提交的历史上下文半径（以天为单位）。如果此变量设置为零，则显示整个历史记录。

指定当调用 git-gui[1] 的“工具”菜单中的相应项时要执行的 shell 命令行。此选项对于每个工具都是必需的。该命令从工作目录的根目录执行，并在环境中接收工具的名称作为 GIT_GUITOOL、当前选择的文件的名称作为 FILENAME 以及当前分支的名称作为 CUR_BRANCH（如果 HEAD 已分离，则 CUR_BRANCH 为空）。

仅当在 GUI 中选择差异时才运行工具。它保证 FILENAME 不为空。

静默运行命令，不创建窗口来显示其输出。

工具执行完成后，不要重新扫描工作目录以查找更改。

在实际运行工具之前显示确认对话框。

向用户请求字符串参数，并通过 ARGS 环境变量将其传递给工具。由于请求参数意味着确认，因此如果启用了此选项，则 confirm 选项无效。如果选项设置为 true、yes 或 1，则对话框使用内置的通用提示；否则使用变量的精确值。

向用户请求单个有效修订版，并设置 REVISION 环境变量。在其他方面，此选项类似于 argPrompt，并且可以与它一起使用。

仅在 revPrompt 子对话框中显示未合并的分支。这对于类似于合并或变基的工具很有用，但不适用于检出或重置等操作。

指定用于提示对话框的标题。默认值为工具名称。

指定在 argPrompt 和 revPrompt 的子部分之前显示在对话框顶部的通用提示字符串。默认值包含实际命令。

指定将用于以 web 格式显示帮助的浏览器。请参阅 git-help[1]。

覆盖 git-help[1] 使用的默认帮助格式。支持 man、info、web 和 html 值。man 为默认值。web 和 html 相同。

如果 Git 检测到拼写错误并且可以识别与错误完全相同的有效命令，Git 将尝试建议正确的命令，甚至自动运行建议。可能的配置值为

指定 HTML 文档所在的路径。支持文件系统路径和 URL。在以web格式显示帮助时，HTML 页面将以该路径为前缀。默认为 Git 安装的文档路径。

覆盖 HTTP 代理，通常使用http_proxy、https_proxy和all_proxy环境变量配置（参见curl(1)）。除了 curl 理解的语法之外，还可以指定一个包含用户名但没有密码的代理字符串，在这种情况下，git 将尝试以与获取其他凭据相同的方式获取密码。有关更多信息，请参见gitcredentials[7]。语法为[protocol://][user[:password]@]proxyhost[:port][/path]。可以在每个远程的基础上覆盖此设置；请参阅remote.<name>.proxy

设置用于对 HTTP 代理进行身份验证的方法。只有当配置的代理字符串包含用户名部分（即格式为user@host或user@host:port）时，此设置才会生效。可以在每个远程的基础上覆盖此设置；请参阅remote.<name>.proxyAuthMethod。两者都可以被GIT_HTTP_PROXY_AUTHMETHOD环境变量覆盖。可能的值为

存储用于对 HTTPS 代理进行身份验证的客户端证书的文件的路径名。可以被GIT_PROXY_SSL_CERT环境变量覆盖。

存储用于对 HTTPS 代理进行身份验证的私钥的文件的路径名。可以被GIT_PROXY_SSL_KEY环境变量覆盖。

启用 Git 对代理 SSL 证书的密码提示。否则，如果证书或私钥已加密，OpenSSL 可能会多次提示用户。可以被GIT_PROXY_SSL_CERT_PASSWORD_PROTECTED环境变量覆盖。

包含应在使用 HTTPS 代理时用于验证代理的证书捆绑包的文件的路径名。可以被GIT_PROXY_SSL_CAINFO环境变量覆盖。

尝试进行身份验证，而不寻求用户名或密码。这可用于尝试进行 GSS-Negotiate 身份验证，而无需在 URL 中指定用户名，因为 libcurl 通常需要用户名才能进行身份验证。

尝试进行身份验证，而无需先进行未经身份验证的尝试并收到 401 响应。这可用于确保所有请求都经过身份验证。如果http.emptyAuth设置为 true，则此值无效。

控制 GSSAPI 凭据委托。从 libcurl 7.21.7 版开始，默认情况下禁用委托。设置参数以告诉服务器在涉及用户凭据时允许委托的内容。与 GSS/kerberos 一起使用。可能的值为

在与服务器通信时传递额外的 HTTP 标头。如果存在多个此类条目，则所有条目都将作为额外的标头添加。为了允许覆盖从系统配置继承的设置，空值将把额外的标头重置为空列表。

包含先前存储的 cookie 行的文件的路径名，如果这些 cookie 与服务器匹配，则应在 Git http 会话中使用。要读取 cookie 的文件的格式应为纯 HTTP 标头或 Netscape/Mozilla cookie 文件格式（参见curl(1)）。将其设置为空字符串，以仅接受来自服务器的新 cookie 并将它们发送回同一连接中的后续请求。请注意，除非设置了 http.saveCookies，否则使用 http.cookieFile 指定的文件仅用作输入。

如果设置，则将请求期间收到的 cookie 存储到 http.cookieFile 指定的文件中。如果 http.cookieFile 未设置或设置为空字符串，则无效。

在与服务器通信时使用指定的 HTTP 协议版本。如果您想强制使用默认值。可用的和默认的版本取决于 libcurl。当前此选项的可能值为

libcurl 发送 HTTP 请求时将首先使用的主机名解析信息。此信息应采用以下格式之一

在协商 SSL 连接时要使用的 SSL 版本，如果您想强制使用默认值。可用的和默认的版本取决于 libcurl 是否针对 NSS 或 OpenSSL 构建以及正在使用的加密库的特定配置。在内部，这会设置CURLOPT_SSL_VERSION选项；有关此选项的格式以及支持的 ssl 版本的更多详细信息，请参阅 libcurl 文档。当前此选项的可能值为

在协商 SSL 连接时要使用的 SSL 密码列表。可用的密码取决于 libcurl 是否针对 NSS 或 OpenSSL 构建以及正在使用的加密库的特定配置。在内部，这会设置CURLOPT_SSL_CIPHER_LIST选项；有关此列表格式的更多详细信息，请参阅 libcurl 文档。

在通过 HTTPS 获取或推送时是否验证 SSL 证书。默认为 true。可以被GIT_SSL_NO_VERIFY环境变量覆盖。

在通过 HTTPS 获取或推送时包含 SSL 证书的文件。可以被GIT_SSL_CERT环境变量覆盖。

在通过 HTTPS 获取或推送时包含 SSL 私钥的文件。可以被GIT_SSL_KEY环境变量覆盖。

启用 Git 对 SSL 证书的密码提示。否则，如果证书或私钥已加密，OpenSSL 可能会多次提示用户。可以被GIT_SSL_CERT_PASSWORD_PROTECTED环境变量覆盖。

包含用于在通过 HTTPS 获取或推送时验证对等方的证书的文件。可以被GIT_SSL_CAINFO环境变量覆盖。

包含用于在通过 HTTPS 获取或推送时验证对等方的 CA 证书的文件的路径。可以被GIT_SSL_CAPATH环境变量覆盖。

要使用的 SSL 后端名称（例如“openssl”或“schannel”）。如果 cURL 缺少在运行时选择 SSL 后端的支持，则会忽略此选项。

用于在 http.sslBackend 设置为“schannel”时在 cURL 中强制执行或禁用证书吊销检查。如果未设置，则默认为true。只有在 Git 持续出错且消息与检查证书的吊销状态有关时才需要禁用此选项。如果 cURL 缺少在运行时设置相关 SSL 选项的支持，则会忽略此选项。

从 cURL v7.60.0 开始，安全通道后端可以使用通过http.sslCAInfo提供的证书捆绑包，但这将覆盖 Windows 证书存储。由于默认情况下不希望这样做，因此当通过http.sslBackend配置了schannel后端时，Git 将告诉 cURL 默认情况下不要使用该捆绑包，除非http.schannelUseSSLCAInfo覆盖此行为。

https 服务的公钥。它可以是 PEM 或 DER 编码的公钥文件的名称，也可以是字符串，该字符串以sha256//开头，后跟公钥的 base64 编码的 sha256 哈希值。另请参阅 libcurl CURLOPT_PINNEDPUBLICKEY。如果设置了此选项但 cURL 不支持，则 git 将退出并显示错误。

尝试在通过普通 FTP 协议连接时使用 AUTH SSL/TLS 和加密数据传输。如果 FTP 服务器出于安全原因需要此功能，或者您希望在远程 FTP 服务器支持时始终安全连接，则可能需要此功能。默认为 false，因为它可能会在配置错误的服务器上触发证书验证错误。

并行启动的 HTTP 请求数。可以被 GIT_HTTP_MAX_REQUESTS 环境变量覆盖。默认为 5。

在请求之间保持的 curl 会话数（跨插槽计算）。在调用 http_cleanup() 之前，它们不会使用 curl_easy_cleanup() 结束。如果未定义 USE_CURL_MULTI，则此值将限制为 1。默认为 1。

智能 HTTP 传输在将数据 POST 到远程系统时使用的缓冲区的最大大小（以字节为单位）。对于大于此缓冲区大小的请求，HTTP/1.1 和 Transfer-Encoding: chunked 用于避免在本地创建大型的 pack 文件。默认为 1 MiB，这足以满足大多数请求。

如果 HTTP 传输速度（以每秒字节数计）低于 http.lowSpeedLimit 持续时间超过 http.lowSpeedTime 秒，则传输将中止。可以被 GIT_HTTP_LOW_SPEED_LIMIT 和 GIT_HTTP_LOW_SPEED_TIME 环境变量覆盖。

一个布尔值，禁用 curl 使用 EPSV ftp 命令。这对于某些不支持 EPSV 模式“较差”的 ftp 服务器很有用。可以被 GIT_CURL_FTP_NO_EPSV 环境变量覆盖。默认为 false（curl 将使用 EPSV）。

呈现给 HTTP 服务器的 HTTP USER_AGENT 字符串。默认值表示 Git 客户端的版本，例如 git/1.7.1。此选项允许您将此值覆盖为更常用的值，例如 Mozilla/4.0。例如，如果通过限制 HTTP 连接到一组常用 USER_AGENT 字符串（但不包括 git/1.7.1 等）的防火墙连接，则可能需要此选项。可以被 GIT_HTTP_USER_AGENT 环境变量覆盖。

git 是否应该遵循 HTTP 重定向。如果设置为 true，git 将透明地遵循它遇到的服务器发出的任何重定向。如果设置为 false，git 将把所有重定向都视为错误。如果设置为 initial，git 将仅对对远程的初始请求遵循重定向，而不对后续的 HTTP 请求遵循重定向。由于 git 使用重定向的 URL 作为后续请求的基础，因此这通常就足够了。默认为 initial。

以上任何 http.* 选项都可以选择性地应用于某些 URL。要使配置键与 URL 匹配，配置键的每个元素都将按以下顺序与 URL 的元素进行比较

存储提交消息的字符编码；Git 本身并不关心，但此信息对于例如从电子邮件导入提交或在 gitk 图形历史浏览器中（以及将来或其他瓷器中的其他地方）是必要的。例如，请参阅 git-mailinfo[1]。默认为 utf-8。

运行 git log 及其相关命令时提交消息转换为的字符编码。

将邮件放入的文件夹，通常是草稿文件夹。例如：“INBOX.Drafts”、“INBOX/Drafts”或“[Gmail]/Drafts”。必需。

用于通过其管道传输命令而不是使用到服务器的直接网络连接来建立到 IMAP 服务器的隧道的命令。当未设置 imap.host 时，必需。

标识服务器的 URL。对于非安全连接，使用 imap:// 前缀；对于安全连接，使用 imaps:// 前缀。当设置 imap.tunnel 时将被忽略，但在其他情况下是必需的。

登录服务器时使用的用户名。

登录服务器时使用的密码。

要连接到服务器上的整数端口号。对于 imap:// 主机默认为 143，对于 imaps:// 主机默认为 993。当设置 imap.tunnel 时将被忽略。

一个布尔值，用于启用/禁用 SSL/TLS 连接使用的服务器证书的验证。默认为 true。当设置 imap.tunnel 时将被忽略。

一个布尔值，用于启用/禁用在发送补丁时使用 html 编码。html 编码的补丁将用 <pre> 括起来，并具有 text/html 的内容类型。具有讽刺意味的是，启用此选项会导致 Thunderbird 将补丁作为 plain/text、format=fixed 电子邮件发送。默认为 false。

指定用于对 IMAP 服务器进行身份验证的身份验证方法。如果 Git 使用 NO_CURL 选项构建，或者您的 curl 版本早于 7.34.0，或者您使用 --no-curl 选项运行 git-imap-send，则唯一支持的方法是 CRAM-MD5。如果未设置此选项，则 git imap-send 使用基本的 IMAP 纯文本 LOGIN 命令。

包含其他配置文件的特殊变量。请参阅主要 git-config[1] 文档中的“配置文件”部分，特别是“包含”和“条件包含”小节。

指定索引文件是否应包含“索引条目结束”部分。这减少了多处理器机器上的索引加载时间，但在使用 2.20 之前的 Git 版本读取索引时会显示消息“忽略 EOIE 扩展”。如果已明确启用 index.threads，则默认为 true，否则默认为 false。

指定索引文件是否应包含“索引条目偏移表”部分。这减少了多处理器机器上的索引加载时间，但在使用 2.20 之前的 Git 版本读取索引时会显示消息“忽略 IEOT 扩展”。如果已明确启用 index.threads，则默认为 true，否则默认为 false。

启用后，使用稀疏目录条目写入索引。除非同时启用了 core.sparseCheckout 和 core.sparseCheckoutCone，否则此选项无效。默认为 false。

指定加载索引时要生成的线程数。这旨在减少多处理器机器上的索引加载时间。指定 0 或 true 将导致 Git 自动检测 CPU 数量并相应地设置线程数。指定 1 或 false 将禁用多线程。默认为 true。

指定应使用哪个版本初始化新的索引文件。这不会影响现有存储库。如果启用了 feature.manyFiles，则默认为 4。

启用后，不要为索引文件计算尾随哈希。这加快了操作索引的 Git 命令（例如 git add、git commit 或 git status）的速度。不存储校验和，而是写入一组值为零的尾随字节，指示已跳过计算。

指定将从中复制模板的目录。（请参阅 git-init[1] 的“模板目录”部分。）

例如，在初始化新存储库时允许覆盖默认分支名称。

允许覆盖新仓库的默认对象格式。请参阅 git-init[1] 中的 --object-format=。命令行选项和 GIT_DEFAULT_HASH 环境变量优先于此配置。

允许覆盖新仓库的默认引用存储格式。请参阅 git-init[1] 中的 --ref-format=。命令行选项和 GIT_DEFAULT_REF_FORMAT 环境变量优先于此配置。

指定用于在 gitweb 中浏览工作仓库的程序。请参阅 git-instaweb[1]。

用于在工作仓库上启动 gitweb 的 HTTP 守护进程命令行。请参阅 git-instaweb[1]。

如果为 true，则由 git-instaweb[1] 启动的 Web 服务器将绑定到本地 IP (127.0.0.1)。

git-instaweb[1] 使用的默认模块路径，而不是 /usr/lib/apache2/modules。仅在 httpd 为 Apache 时使用。

将 gitweb httpd 绑定到的端口号。请参阅 git-instaweb[1]。

设置为 true 时，允许用户在交互式命令中使用单个按键提供单字符输入（即，无需按 Enter 键）。目前，git-add[1]、git-checkout[1]、git-restore[1]、git-commit[1]、git-reset[1] 和 git-stash[1] 的 --patch 模式使用了此功能。

当交互式命令（例如 git add --patch）显示彩色 diff 时，git 会将 diff 通过此配置变量定义的 shell 命令传递。该命令可以进一步标记 diff 以供人类使用，前提是它与原始 diff 中的行保持一对一对应关系。默认为禁用（不进行过滤）。

如果为 true，则 git-log[1]、git-show[1] 和 git-whatchanged[1] 将假定 --abbrev-commit。可以使用 --no-abbrev-commit 覆盖此选项。

设置 log 命令的默认日期时间模式。为 log.date 设置值类似于使用 git log 的 --date 选项。有关详细信息，请参阅 git-log[1]。

打印出 log 命令显示的任何提交的引用名称。如果指定了 short，则不会打印引用名称前缀 refs/heads/、refs/tags/ 和 refs/remotes/。如果指定了 full，则将打印完整的引用名称（包括前缀）。如果指定了 auto，则如果输出到终端，则引用名称将显示为如果给出了 short 一样，否则不显示引用名称。这与 git log 的 --decorate 选项相同。

默认情况下，git log 仅显示某些已知引用命名空间的修饰。如果指定了 all，则将所有引用显示为修饰。

从日志修饰中排除指定的模式。这类似于 --decorate-refs-exclude 命令行选项，但配置选项可以被 --decorate-refs 选项覆盖。

指定 --diff-merges=on 时使用的 diff 格式，有关详细信息，请参阅 git-log[1] 中的 --diff-merges。默认为 separate。

如果为 true，则当给定单个 <path> 时，git log 将表现得好像使用了 --follow 选项一样。这与 --follow 具有相同的限制，即它不能用于跟踪多个文件，并且在非线性历史记录中效果不佳。

一系列颜色，用逗号分隔，可用于在 git log --graph 中绘制历史记录线。

如果为 true，则初始提交将显示为一个大型创建事件。这等效于针对空树的 diff。像 git-log[1] 或 git-whatchanged[1] 这样的工具通常会隐藏根提交，但现在会显示它。默认为 true。

如果为 true，则 git-log[1]、git-show[1] 和 git-whatchanged[1] 将假定 --show-signature。

如果为 true，则 git-log[1]、git-show[1] 和 git-whatchanged[1] 将假定 --use-mailmap，否则假定 --no-use-mailmap。默认为 true。

可以是 "advertise"（默认值）、"allow" 或 "ignore"。如果是 "advertise"，则服务器将响应客户端发送 "unborn"（如 gitprotocol-v2[5] 中所述），并在协议 v2 功能公告期间宣传对该功能的支持。"allow" 与 "advertise" 相同，只是服务器不会宣传对该功能的支持；这对于无法原子更新的负载均衡服务器（例如）很有用，因为管理员可以配置 "allow"，然后延迟一段时间后配置 "advertise"。

如果为 true，则 git-mailinfo[1]（因此 git-am[1]）默认情况下将表现得好像在命令行上提供了 --scissors 选项一样。启用此功能时，它会删除消息正文中剪刀线（即主要由 ">8"、"8<" 和 "-" 组成）之前的全部内容。

增强型 mailmap 文件的位置。首先加载位于仓库根目录中的默认 mailmap，然后加载此变量指向的 mailmap 文件。mailmap 文件的位置可能位于仓库子目录中，或者位于仓库外部的某个位置。请参阅 git-shortlog[1] 和 git-blame[1]。

与 mailmap.file 类似，但将值视为对仓库中 blob 的引用。如果同时给出了 mailmap.file 和 mailmap.blob，则两者都会被解析，其中 mailmap.file 中的条目优先。在裸仓库中，默认为 HEAD:.mailmap。在非裸仓库中，默认为空。

此布尔型配置选项控制某些命令是否在完成其正常工作后运行 git maintenance run --auto。默认为 true。

许多 Git 命令在将数据写入仓库后会触发自动维护。此布尔型配置选项控制此自动维护是否在前景发生，或者维护进程是否应分离并在后台继续运行。

此字符串配置选项提供了一种方法来指定一些推荐的后台维护计划。这仅影响在 git maintenance run --schedule=X 命令期间运行的任务，前提是没有提供 --task=<task> 参数。此外，如果设置了 maintenance.<task>.schedule 配置值，则将使用该值而不是 maintenance.strategy 提供的值。可能的策略字符串为

此布尔型配置选项控制在未向 git maintenance run 指定 --task 选项时是否运行名称为 <task> 的维护任务。如果存在 --task 选项，则会忽略这些配置值。默认情况下，只有 maintenance.gc.enabled 为 true。

此配置选项控制在 git maintenance run --schedule=<frequency> 命令期间给定的 <task> 是否运行。该值必须是 "hourly"、"daily" 或 "weekly" 之一。

此整数配置选项控制作为 git maintenance run --auto 的一部分运行 commit-graph 任务的频率。如果为零，则 commit-graph 任务不会使用 --auto 选项运行。负值将强制每次运行该任务。否则，正值表示当不在 commit-graph 文件中的可到达提交数至少为 maintenance.commit-graph.auto 的值时，应运行该命令。默认值为 100。

此整数值配置选项控制在 git maintenance run --auto 中运行 loose-objects 任务的频率。如果为零，则 loose-objects 任务不会在使用 --auto 选项时运行。负值将强制任务每次都运行。否则，正值表示当松散对象的数量至少为 maintenance.loose-objects.auto 的值时运行该命令。默认值为 100。

此整数值配置选项控制在 git maintenance run --auto 中运行 incremental-repack 任务的频率。如果为零，则 incremental-repack 任务不会在使用 --auto 选项时运行。负值将强制任务每次都运行。否则，正值表示当不在多包索引中的包文件数量至少为 maintenance.incremental-repack.auto 的值时运行该命令。默认值为 10。

指定可用于以 man 格式显示帮助的程序。请参阅 git-help[1]。

指定用于调用指定 man 查看器的命令。指定的命令在 shell 中执行，并将手册页作为参数传递。（请参阅 git-help[1]。）

覆盖可用于以 man 格式显示帮助的给定工具的路径。请参阅 git-help[1]。

指定合并时冲突的块写入工作树文件的样式。默认值为“merge”，它显示 <<<<<<< 冲突标记、一方所做的更改、======= 标记、另一方所做的更改，然后是 >>>>>>> 标记。另一种样式“diff3”添加了 ||||||| 标记和 ======= 标记之前的原始文本。“merge”样式往往会产生比 diff3 更小的冲突区域，这是因为排除了原始文本，并且当两侧的某些行匹配时，它们只是从冲突区域中提取出来的。另一种备选样式“zdiff3”类似于 diff3，但在冲突区域的开头或结尾附近出现匹配行时，会从冲突区域中删除两侧的匹配行。

如果在没有任何提交参数的情况下调用合并，则使用存储在其远程跟踪分支中的最后观察到的值合并当前分支配置的上游分支。将查询 branch.<current branch>.merge 的值，这些值命名了由 branch.<current branch>.remote 命名的远程分支，然后通过 remote.<remote>.fetch 将它们映射到其对应的远程跟踪分支，并将这些跟踪分支的尖端合并。默认为 true。

默认情况下，Git 在合并当前提交的后代提交时不会创建额外的合并提交。而是将当前分支的尖端快进。当设置为 false 时，此变量告诉 Git 在这种情况下创建额外的合并提交（相当于从命令行给出 --no-ff 选项）。当设置为 only 时，仅允许此类快进合并（相当于从命令行给出 --ff-only 选项）。

如果为 true，则等效于 --verify-signatures 命令行选项。有关详细信息，请参阅 git-merge[1]。

除了分支名称外，还使用与其关联的分支描述文本填充日志消息。默认为 false。

除了分支名称外，还使用最多指定数量的实际提交的一行描述填充日志消息，这些提交正在被合并。默认为 false，true 是 20 的同义词。

通过向此多值配置变量添加匹配集成分支名称的通配符，为合并到这些集成分支计算的默认合并消息将从其标题中省略“into <branch name>”。

在合并期间重命名检测的详尽部分中要考虑的文件数量。如果未指定，则默认为 diff.renameLimit 的值。如果既未指定 merge.renameLimit 也未指定 diff.renameLimit，则当前默认为 7000。如果关闭了重命名检测，则此设置无效。

Git 是否检测重命名。如果设置为“false”，则禁用重命名检测。如果设置为“true”，则启用基本重命名检测。默认为 diff.renames 的值。

Git 是否检测目录重命名，这会影响在合并时如何处理在历史记录的一侧添加到目录的新文件，而该目录在历史记录的另一侧已重命名。如果 merge.directoryRenames 设置为“false”，则禁用目录重命名检测，这意味着此类新文件将保留在旧目录中。如果设置为“true”，则启用目录重命名检测，这意味着此类新文件将移动到新目录中。如果设置为“conflict”，则将报告此类路径的冲突。如果 merge.renames 为 false，则忽略 merge.directoryRenames 并将其视为 false。默认为“conflict”。

告诉 Git 存储库中文件的规范表示形式已随时间变化（例如，较早的提交记录带有 CRLF 行结尾的文本文件，但最近的提交使用 LF 行结尾）。在这样的存储库中，Git 可以在执行合并之前将提交中记录的数据转换为规范形式，以减少不必要的冲突。有关更多信息，请参阅 gitattributes[5] 中的“合并具有不同签入/签出属性的分支”部分。

是否在合并结束时打印 ORIG_HEAD 和合并结果之间的 diffstat。默认为 true。

当设置为 true 时，在操作开始之前自动创建一个临时存储条目，并在操作结束之后应用它。这意味着您可以在脏工作树上运行合并。但是，请谨慎使用：成功合并后的最终存储应用可能会导致非平凡的冲突。此选项可以通过 git-merge[1] 的 --no-autostash 和 --autostash 选项覆盖。默认为 false。

控制 git-mergetool[1] 使用哪个合并工具。以下列表显示了有效的内置值。任何其他值都被视为自定义合并工具，并且需要定义相应的 mergetool.<tool>.cmd 变量。

当指定 -g/--gui 标志时，控制 git-mergetool[1] 使用哪个合并工具。以下列表显示了有效的内置值。任何其他值都被视为自定义合并工具，并且需要定义相应的 mergetool.<guitool>.cmd 变量。

控制递归合并策略显示的输出量。级别 0 除了在检测到冲突时显示最终错误消息外，不输出任何内容。级别 1 仅输出冲突，级别 2 输出冲突和文件更改。级别 5 及以上输出调试信息。默认级别为 2。可以被 GIT_MERGE_VERBOSITY 环境变量覆盖。

为自定义低级合并驱动程序定义人类可读的名称。有关详细信息，请参阅 gitattributes[5]。

定义实现自定义低级合并驱动程序的命令。有关详细信息，请参阅 gitattributes[5]。

命名在执行公共祖先之间的内部合并时要使用的低级合并驱动程序。有关详细信息，请参阅 gitattributes[5]。

覆盖给定工具的路径。如果您的工具不在 PATH 中，这将很有用。

指定用于调用指定合并工具的命令。指定的命令在 shell 中执行，以下变量可用：BASE 是包含要合并的文件的公共基准的临时文件的名称（如果可用）；LOCAL 是包含当前分支上文件内容的临时文件的名称；REMOTE 是包含要合并的分支中文件内容的临时文件的名称；MERGED 包含合并工具应将合并结果写入的文件的名称。

允许用户覆盖特定工具的全局 mergetool.hideResolved 值。有关完整描述，请参阅 mergetool.hideResolved。

对于自定义合并命令，指定是否可以使用合并命令的退出代码来确定合并是否成功。如果未将其设置为 true，则会检查合并目标文件的时间戳，如果文件已更新，则假定合并已成功；否则，将提示用户指示合并是否成功。

旧版本的 meld 不支持 --output 选项。Git 将尝试通过检查 meld --help 的输出结果来检测 meld 是否支持 --output。配置 mergetool.meld.hasOutput 将使 Git 跳过这些检查并改用配置的值。将 mergetool.meld.hasOutput 设置为 true 会告诉 Git 无条件地使用 --output 选项，而 false 则避免使用 --output。

如果提供--auto-merge选项，meld将自动合并所有无冲突的部分，突出显示冲突的部分，并等待用户做出决定。将mergetool.meld.useAutoMerge设置为true告诉Git无条件地使用meld的--auto-merge选项。将此值设置为auto使git检测是否支持--auto-merge，并且仅在可用时使用--auto-merge。值为false完全避免使用--auto-merge，这是默认值。

配置vimdiff的<variant>的分割窗口布局，其中<variant>可以是vimdiff、nvimdiff或gvimdiff。在使用--tool=<variant>（或者如果merge.tool配置为<variant>则不使用--tool）启动git mergetool时，Git将查阅mergetool.<variant>.layout以确定工具的布局。如果无法使用特定于变体的配置，则将使用vimdiff的配置作为后备。如果该配置也无法使用，则将使用具有4个窗口的默认布局。有关如何配置布局，请参阅git-mergetool[1]中的“BACKEND SPECIFIC HINTS”部分。

在合并过程中，Git会自动解决尽可能多的冲突，并写入包含冲突标记的MERGED文件，这些标记围绕着它无法解决的任何冲突；LOCAL和REMOTE通常代表Git冲突解决之前文件的版本。此标志导致LOCAL和REMOTE被覆盖，以便仅将未解决的冲突呈现给合并工具。可以通过mergetool.<tool>.hideResolved配置变量为每个工具进行配置。默认为false。

执行合并后，可以将包含冲突标记的原始文件保存为扩展名为.orig的文件。如果此变量设置为false，则不会保留此文件。默认为true（即保留备份文件）。

调用自定义合并工具时，Git会使用一组临时文件传递给工具。如果工具返回错误并且此变量设置为true，则将保留这些临时文件；否则，在工具退出后将删除它们。默认为false。

默认情况下，Git会在工作树中写入冲突文件的临时BASE、LOCAL和REMOTE版本。当设置为true时，Git将尝试为这些文件使用临时目录。默认为false。

在每次调用合并解决程序之前提示。

设置为true以默认使用merge.guitool（相当于指定--gui参数），或设置为auto以根据DISPLAY环境变量值的存在选择merge.guitool或merge.tool。默认为false，其中必须显式提供--gui参数才能使用merge.guitool。

在解决注释冲突时默认选择哪种合并策略。必须是manual、ours、theirs、union或cat_sort_uniq之一。默认为manual。有关每种策略的更多信息，请参阅git-notes[1]的“NOTES MERGE STRATEGIES”部分。

在将注释合并到refs/notes/<name>时选择哪种合并策略。这将覆盖更通用的“notes.mergeStrategy”。有关可用策略的更多信息，请参阅git-notes[1]的“NOTES MERGE STRATEGIES”部分。

除了core.notesRef或GIT_NOTES_REF设置的默认值之外，还要读取哪个ref（或refs，如果为glob或指定多次）的注释，以便在使用git log系列命令显示提交消息时使用。

使用<command>（目前为amend或rebase）重写提交时，如果此变量为false，则git将不会从原始提交复制注释到重写后的提交。默认为true。另请参阅下面的“notes.rewriteRef”。

在重写期间复制注释时（请参阅“notes.rewrite.<command>”选项），如果目标提交已具有注释，则确定该怎么办。必须是overwrite、concatenate、cat_sort_uniq或ignore之一。默认为concatenate。

在重写期间复制注释时，指定应复制其注释的（完全限定的）ref。可以是glob，在这种情况下，将复制所有匹配ref中的注释。您也可以多次指定此配置。

当命令行上未给出窗口大小时，git-pack-objects[1]使用的窗口大小。默认为10。

当命令行上未给出最大深度时，git-pack-objects[1]使用的最大delta深度。默认为50。最大值为4095。

当命令行上未给出限制时，git-pack-objects[1]中每个线程为打包窗口内存消耗的最大内存大小。该值可以后缀“k”、“m”或“g”。未配置（或显式设置为0）时，将没有限制。

一个整数-1..9，指示打包文件中对象的压缩级别。-1是zlib的默认值。0表示不压缩，1..9是各种速度/大小权衡，9是最慢的。如果未设置，则默认为core.compression。如果未设置，则默认为-1，即zlib的默认值，即“速度和压缩之间的默认折衷（目前相当于级别6）”。

当为true或“single”，并且启用可达性位图时，pack-objects将尝试逐字发送位图打包文件的部分内容。当为“multi”，并且可以使用多打包可达性位图时，pack-objects将尝试发送MIDX中所有打包文件的部分内容。

配置一组delta岛的扩展正则表达式。有关详细信息，请参阅git-pack-objects[1]中的“DELTA ISLANDS”。

指定一个岛屿名称，该名称可以首先打包其对象。这会在一个打包文件的前面创建一种伪打包，以便来自指定岛屿的对象有望更快地复制到应提供给请求这些对象的用户的任何打包文件中。在实践中，这意味着指定的岛屿应该可能对应于存储库中最常克隆的内容。另请参阅git-pack-objects[1]中的“DELTA ISLANDS”。

在写入打包文件之前，git-pack-objects[1]用于缓存delta的最大内存（以字节为单位）。此缓存用于通过在找到所有对象的最佳匹配后不必重新计算最终的delta结果来加快写入对象阶段的速度。不过，在内存紧张的机器上重新打包大型存储库可能会受到严重影响，尤其是在此缓存将系统推入交换的情况下。值为0表示没有限制。可以使用最小的1字节大小来虚拟地禁用此缓存。默认为256 MiB。

在git-pack-objects[1]中缓存的delta的最大大小。此缓存用于通过在找到所有对象的最佳匹配后不必重新计算最终的delta结果来加快写入对象阶段的速度。默认为1000。最大值为65535。

指定在搜索最佳delta匹配时要生成的线程数。这需要git-pack-objects[1]使用pthreads编译，否则此选项将被忽略并发出警告。这旨在减少多处理器机器上的打包时间。但是，delta搜索窗口所需的内存量将乘以线程数。指定0将导致Git自动检测CPU数量并相应地设置线程数。

指定默认的打包索引版本。有效值为1，用于Git 1.5.2之前的版本使用的旧打包索引，以及2，用于新的打包索引，该索引具有大于4 GB的打包文件的功能以及针对损坏的打包文件重新打包的适当保护。版本2是默认值。请注意，每当相应的打包文件大于2 GB时，版本2都会被强制执行，并且此配置选项将被忽略。

打包文件的大小上限。此设置仅影响重新打包时打包到文件的情况，即git://协议不受影响。它可以通过git-repack[1]的--max-pack-size选项覆盖。达到此限制会导致创建多个打包文件。

如果为 true，则 git 将在打包到标准输出时（例如，在获取的服务器端）使用 pack 位图（如果可用）。默认为 true。您通常不需要关闭它，除非您正在调试 pack 位图。

如果为 true，则 Git 将使用一种实验性算法来计算使用位图的可达性查询。与其为所有否定的提示构建完整的位图然后将它们组合在一起，不如将具有现有位图的否定提示视为附加（即，如果它们存在则将其 OR 到结果中，否则忽略它们），并在边界处构建位图。

如果为 true，则当存在 --revs 选项时，git 将默认使用 git pack-objects 中的 --sparse 选项。此算法仅遍历出现在引入新对象的路径中的树。在计算要发送的小更改的包时，这可以带来显着的性能优势。但是，如果包含的提交包含某些类型的直接重命名，则可能会将额外对象添加到包文件中。默认为 true。

在选择哪些提交将接收位图时，优先考虑任何此配置值的任何后缀的任何引用的顶端的提交，而不是“选择窗口”中的任何其他提交。

这是 repack.writeBitmaps 的已弃用同义词。

如果为 true，则 git 将在位图索引中包含“哈希缓存”部分（如果写入了一个）。此缓存可用于为 git 的增量启发式提供信息，从而可能导致位图对象和非位图对象之间产生更好的增量（例如，在旧的位图包和自上次 gc 以来已推送的对象之间提供获取时）。缺点是它消耗每个对象 4 字节的磁盘空间。默认为 true。

如果为 true，则 Git 将在位图索引中包含“查找表”部分（如果写入了一个）。此表用于尽可能延迟加载各个位图。这在具有相对较大的位图索引的存储库中可能很有用。默认为 false。

如果为 true，则 git 将读取任何可能可用的 .rev 文件（请参阅：gitformat-pack[5]）。如果为 false，则将从头开始生成反向索引并将其存储在内存中。默认为 true。

如果为 true，则 git 将为其在所有位置（除了 git-fast-import[1] 和批量签入机制中）写入的每个新 packfile 写入相应的 .rev 文件（请参阅：gitformat-pack[5]）。默认为 true。

如果值为布尔值，则在写入 tty 时打开或关闭特定 Git 子命令输出的分页。否则，使用 pager.<cmd> 的值指定的分页程序为子命令打开分页。如果在命令行上指定了 --paginate 或 --no-pager，则它优先于此选项。要禁用所有命令的分页，请将 core.pager 或 GIT_PAGER 设置为 cat。

如 git-log[1] 中所述，--pretty= 格式字符串的别名。此处定义的任何别名都可以像内置漂亮格式一样使用。例如，运行 git config pretty.changelog "format:* %H %s" 将导致调用 git log --pretty=changelog 等效于运行 git log "--pretty=format:* %H %s"。请注意，与内置格式同名的别名将被静默忽略。

如果设置为“true”，则在为部分克隆获取其他对象时假定 --quiet。

如果设置，则为所有未明确具有策略的协议（protocol.<name>.allow）提供用户定义的默认策略。默认情况下，如果未设置，则已知安全的协议（http、https、git、ssh）的默认策略为 always，已知危险的协议（ext）的默认策略为 never，所有其他协议（包括文件）的默认策略为 user。支持的策略

设置克隆/获取/推送命令使用的协议 <name> 的策略。有关可用策略，请参见上面的 protocol.allow。

如果设置，客户端将尝试使用指定的协议版本与服务器通信。如果服务器不支持它，则通信将回退到版本 0。如果未设置，则默认为 2。支持的版本

默认情况下，当合并作为当前提交的后代的提交时，Git 不会创建额外的合并提交。相反，当前分支的顶端将快速转发。当设置为 false 时，此变量告诉 Git 在这种情况下创建额外的合并提交（相当于从命令行提供 --no-ff 选项）。当设置为 only 时，仅允许此类快速转发合并（相当于从命令行提供 --ff-only 选项）。此设置在拉取时会覆盖 merge.ff。

如果为 true，则在运行“git pull”时，将分支重新定位到已获取的分支之上，而不是合并来自默认远程的默认分支。有关在每个分支的基础上设置此选项，请参阅“branch.<name>.rebase”。

一次拉取多个分支时要使用的默认合并策略。

拉取单个分支时要使用的默认合并策略。

如果设置为“true”，则在当前分支不存在上游跟踪时，在默认推送时假定 --set-upstream；此选项对 simple、upstream 和 current 的 push.default 选项有效。如果默认情况下您希望将新分支推送到默认远程（类似于 push.default=current 的行为），并且您还想设置上游跟踪，则此选项很有用。最有可能从此选项中受益的工作流程是所有分支都期望在远程具有相同名称的 simple 中心工作流程。

定义如果未给出 refspec（无论来自命令行、配置还是其他位置），则 git push 应采取的操作。不同的值非常适合特定的工作流程；例如，在纯中心工作流程中（即获取源等于推送目标），upstream 可能就是您想要的。可能的值为

如果设置为 true，则默认启用 --follow-tags 选项。您可以在推送时通过指定 --no-follow-tags 来覆盖此配置。

可以设置为布尔值或字符串 if-asked。true 值会导致所有推送都进行 GPG 签名，就像将 --signed 传递给 git-push[1] 一样。字符串 if-asked 会在服务器支持的情况下对推送进行签名，就像将 --signed=if-asked 传递给 git push 一样。false 值可能会覆盖来自较低优先级配置文件的值。显式命令行标志始终会覆盖此配置选项。

当从命令行未给出 --push-option=<option> 参数时，git push 的行为就像将此变量的每个 <value> 作为 --push-option=<value> 给出一样。

Example:

/etc/gitconfig
  push.pushoption = a
  push.pushoption = b

~/.gitconfig
  push.pushoption = c

repo/.git/config
  push.pushoption =
  push.pushoption = b

This will result in only b (a and c are cleared).

可以是 "check"、"on-demand"、"only" 或 "no"，其行为与 "push --recurse-submodules" 相同。如果未设置，则默认使用 no，除非设置了 submodule.recurse（在这种情况下，true 值表示 on-demand）。

如果设置为 "true"，则等效于在命令行中将 --force-if-includes 指定为 git-push[1] 的选项。在推送时添加 --no-force-if-includes 会覆盖此配置设置。

如果设置为 "true"，则尝试通过协商轮次来减小发送的 packfile 的大小，在协商轮次中，客户端和服务器尝试查找共同的提交。如果为 "false"，Git 将仅依赖于服务器的 ref 广告来查找共同的提交。

如果设置为 "false"，则即使 pack.useBitmaps 为 "true"，也会禁用 "git push" 的位图使用，而不会阻止其他 git 操作使用位图。默认为 true。

用于变基的默认后端。可能的选项是 apply 或 merge。将来，如果合并后端获得了应用后端的全部剩余功能，则此设置可能会变得未使用。

是否显示自上次变基以来上游发生更改的 diffstat。默认为 false。

如果设置为 true，则默认情况下为交互模式启用 git-rebase[1] 的 --autosquash 选项。这可以通过 --no-autosquash 选项覆盖。

设置为 true 时，会在操作开始前自动创建一个临时存储条目，并在操作结束后应用它。这意味着您可以在脏工作树上运行变基。但是，请谨慎使用：成功变基后最终的存储应用可能会导致非平凡的冲突。此选项可以通过 git-rebase[1] 的 --no-autostash 和 --autostash 选项覆盖。默认为 false。

如果设置为 true，则默认启用 --update-refs 选项。

如果设置为 "warn"，则 git rebase -i 会在删除一些提交（例如删除一行）时打印警告，但变基仍将继续。如果设置为 "error"，则会打印先前的警告并停止变基，然后可以使用 git rebase --edit-todo 来更正错误。如果设置为 "ignore"，则不会进行任何检查。要删除提交而不发出警告或错误，请在待办事项列表中使用 drop 命令。默认为 "ignore"。

一个格式字符串，如 git-log[1] 中指定，用于交互式变基期间的待办事项列表。格式将自动在格式前加上提交哈希。

如果设置为 true，则 git rebase 将在待办事项列表中使用缩写命令名称，从而产生如下内容

	p deadbee The oneline of the commit
	p fa1afe1 The oneline of the next commit
	...

	pick deadbee The oneline of the commit
	pick fa1afe1 The oneline of the next commit
	...

自动重新安排失败的 exec 命令。这仅在交互模式下（或提供 --exec 选项时）才有意义。这与指定 --reschedule-failed-exec 选项相同。

如果设置为 false，则默认设置 --no-fork-point 选项。

是否以及如何默认设置 --rebase-merges 选项。可以是 rebase-cousins、no-rebase-cousins 或布尔值。设置为 true 或 no-rebase-cousins 等效于 --rebase-merges=no-rebase-cousins，设置为 rebase-cousins 等效于 --rebase-merges=rebase-cousins，设置为 false 等效于 --no-rebase-merges。在命令行上传递 --rebase-merges（带或不带参数）会覆盖任何 rebase.rebaseMerges 配置。

从提交主题生成标签名称时，将名称截断到此长度。默认情况下，名称会被截断到略小于 NAME_MAX（以允许例如为相应的松散引用写入 .lock 文件）。

默认情况下，git-receive-pack 会将其原子推送功能宣传给其客户端。如果您不想宣传此功能，请将此变量设置为 false。

设置为 true 时，git-receive-pack 会将其推送选项功能宣传给其客户端。默认为 false。

默认情况下，git-receive-pack 在从 git-push 接收数据并更新引用后会运行 "git maintenance run --auto"。您可以通过将此变量设置为 false 来停止它。

通过将此变量设置为字符串，git receive-pack 将接受 git push --signed 并使用 HMAC 使用此字符串作为密钥来保护的“nonce”对其进行验证。

当 git push --signed 发送带有“nonce”的推送证书时，该证书是在此时间段内由服务于同一存储库的 receive-pack 发出的，将证书中找到的“nonce”导出到 GIT_PUSH_CERT_NONCE 以供钩子使用（而不是 receive-pack 要求发送方包含的内容）。这可能使得在 pre-receive 和 post-receive 中编写检查更容易一些。他们不必检查记录 nonce 过期多少秒的 GIT_PUSH_CERT_NONCE_SLOP 环境变量来决定是否要接受证书，他们只需要检查 GIT_PUSH_CERT_NONCE_STATUS 是否为 OK。

如果设置为 true，则 git-receive-pack 将检查所有接收到的对象。有关检查的内容，请参阅 transfer.fsckObjects。默认为 false。如果未设置，则使用 transfer.fsckObjects 的值。

类似于 fsck.<msg-id>，但由 git-receive-pack[1] 而不是 git-fsck[1] 使用。有关详细信息，请参阅 fsck.<msg-id> 文档。

类似于 fsck.skipList，但由 git-receive-pack[1] 而不是 git-fsck[1] 使用。有关详细信息，请参阅 fsck.skipList 文档。

在从客户端接收包后，receive-pack 在处理包的过程中可能不会产生任何输出（如果指定了--quiet），这会导致某些网络断开 TCP 连接。启用此选项后，如果receive-pack在此阶段 receive.keepAlive 秒内未传输任何数据，它将发送一个简短的保活数据包。默认值为 5 秒；设置为 0 表示完全禁用保活。

如果推送接收到的对象数量低于此限制，则这些对象将被解包到松散的对象文件中。但是，如果接收到的对象数量等于或超过此限制，则接收到的包将在添加任何缺少的 delta 基数后存储为包。从推送中存储包可以使推送操作更快地完成，尤其是在文件系统速度较慢的情况下。如果未设置，则使用transfer.unpackLimit的值。

如果传入包流的大小大于此限制，则 git-receive-pack 将出错，而不是接受包文件。如果未设置或设置为 0，则大小不受限制。

如果设置为 true，则 git-receive-pack 将拒绝删除 ref 的 ref 更新。使用此选项可通过推送防止此类 ref 删除。

如果设置为 true，则 git-receive-pack 将拒绝删除非裸仓库当前签出分支的 ref 更新。

如果设置为 true 或 "refuse"，则 git-receive-pack 将拒绝对非裸仓库当前签出分支的 ref 更新。此类推送可能很危险，因为它会导致 HEAD 与索引和工作树不同步。如果设置为 "warn"，则将此类推送的警告打印到 stderr，但允许推送继续。如果设置为 false 或 "ignore"，则允许此类推送，且不显示任何消息。默认为 "refuse"。

如果设置为 true，则 git-receive-pack 将拒绝不是快进的 ref 更新。使用此选项可通过推送防止此类更新，即使该推送是强制的。初始化共享仓库时会设置此配置变量。

此变量与transfer.hideRefs相同，但仅适用于receive-pack（因此会影响推送，但不会影响获取）。git push尝试更新或删除隐藏的 ref 将被拒绝。

这是一个多值变量，用于定义匹配receive-pack中命令的引用前缀。匹配前缀的命令将由外部钩子 "proc-receive" 执行，而不是由内部execute_commands函数执行。如果未定义此变量，则永远不会使用 "proc-receive" 钩子，所有命令都将由内部execute_commands函数执行。

git config --system --add receive.procReceiveRefs ad:refs/heads
git config --system --add receive.procReceiveRefs !:refs/heads

如果设置为 true，则 git-receive-pack 将在从 git-push 接收数据并更新 ref 后运行 git-update-server-info。

如果设置为 true，则当新的 ref 需要新的浅根时，可以更新 .git/shallow。否则，将拒绝这些 ref。

reftable 后端在写入块时使用的字节大小。块大小由写入器确定，不一定是 2 的幂。块大小必须大于存储库中使用的最长引用名称或日志条目，因为引用不能跨越块。

创建重启点的间隔。reftable 后端在文件创建时确定重启点。对于较小的块大小（4k 或 8k），每 16 个可能更合适，对于较大的块大小（64k），每 64 个更合适。

reftable 后端是否应写入对象块。对象块是对象 ID 到指向它们的引用的反向映射。

每当 reftable 后端将新表附加到堆栈时，它都会执行自动压缩以确保只有少量表。后端通过确保表在每个表的相应大小方面形成一个几何序列来做到这一点。

每当 reftable 后端将新表附加到堆栈时，它都必须在更新中央 "tables.list" 文件之前锁定它。此配置控制如果另一个进程已获取锁，则该进程将等待多长时间才能获取锁。值 0 表示根本不重试；-1 表示无限期重试。默认为 100（即，重试 100 毫秒）。

默认推送到的远程仓库。覆盖所有分支的branch.<name>.remote，并被特定分支的branch.<name>.pushRemote覆盖。

远程仓库的 URL。请参阅git-fetch[1]或git-push[1]。配置的远程仓库可以有多个 URL；在这种情况下，第一个用于获取，所有 URL 都用于推送（假设未定义remote.<name>.pushurl）。将此键设置为空字符串将清除 url 列表，允许您覆盖之前的配置。

远程仓库的推送 URL。请参阅git-push[1]。如果配置的远程仓库中存在pushurl选项，则它将用于推送，而不是remote.<name>.url。配置的远程仓库可以有多个推送 URL；在这种情况下，推送将发送到所有 URL。将此键设置为空字符串将清除 url 列表，允许您覆盖之前的配置。

对于需要 curl（http、https 和 ftp）的远程仓库，用于该远程仓库的代理的 URL。设置为空字符串以禁用该远程仓库的代理。

对于需要 curl（http、https 和 ftp）的远程仓库，用于对正在使用的代理进行身份验证的方法（可能在remote.<name>.proxy中设置）。请参阅http.proxyAuthMethod。

git-fetch[1]的默认“refspec”集。请参阅git-fetch[1]。

git-push[1]的默认“refspec”集。请参阅git-push[1]。

如果为 true，则推送到此远程仓库将自动表现得好像在命令行上给出了--mirror选项。

remote.<name>.skipFetchAll的已弃用同义词（如果两者都在配置文件中设置了不同的值，则将使用最后出现的那个值）。

如果为 true，则在使用git-fetch[1]、git-remote[1]的update子命令更新时，将跳过此远程仓库，并被git maintenance的预取任务忽略。

推送时在远程端执行的默认程序。请参阅git-push[1]的选项 --receive-pack。

获取时在远程端执行的默认程序。请参阅git-fetch-pack[1]的选项 --upload-pack。

将此值设置为 --no-tags 会在从远程 <name> 获取时禁用自动标签跟踪。将其设置为 --tags 将从远程 <name> 获取每个标签，即使它们无法从远程分支头访问。将这些标志直接传递给git-fetch[1]可以覆盖此设置。请参阅git-fetch[1]的选项 --tags 和 --no-tags。

将其设置为值 <vcs> 将导致 Git 使用 git-remote-<vcs> 辅助程序与远程仓库交互。

如果设置为 true，则默认情况下从该远程仓库获取还会删除远程仓库中不再存在的任何远程跟踪引用（就像在命令行上给出了--prune选项一样）。如果存在，则覆盖fetch.prune设置。

如果设置为 true，则默认情况下从该远程仓库获取还会删除远程仓库中不再存在的任何本地标签，前提是通过remote.<name>.prune、fetch.prune或--prune在一般情况下启用了修剪。如果存在，则覆盖fetch.pruneTags设置。

当设置为 true 时，此远程仓库将用于获取承诺者对象。

从该承诺者远程仓库获取时将应用的过滤器。更改或清除此值只会影响新提交的获取。要获取已存在于本地对象数据库中的提交关联的对象，请使用 git-fetch[1] 的 --refetch 选项。

"git remote update <group>" 获取的远程仓库列表。请参阅 git-remote[1]。

默认情况下，git-repack[1] 创建使用 delta-base 偏移量的包。如果您需要与低于 1.4.4 版本的 Git 共享您的仓库（无论是直接共享还是通过 http 等哑协议共享），则需要将此选项设置为 "false" 并重新打包。通过原生协议访问旧版 Git 不受此选项影响。

如果设置为 true，则使 git repack 的行为如同传递了 --pack-kept-objects。有关详细信息，请参阅 git-repack[1]。通常默认为 false，但如果正在写入位图索引（通过 --write-bitmap-index 或 repack.writeBitmaps），则默认为 true。

如果设置为 true，则使 git repack 的行为如同传递了 --delta-islands。默认为 false。

当为 true 时，git 会在将所有对象打包到磁盘时写入位图索引（例如，当运行 git repack -a 时）。该索引可以加快后续为克隆和获取创建的包的“统计对象”阶段的速度，但会占用一些磁盘空间并在初始重新打包时花费额外的时间。如果创建了多个包文件，则此操作无效。在裸仓库中默认为 true，否则为 false。

如果设置为 false，则 git-repack[1] 不会运行 git-update-server-info[1]。默认为 true。当为 true 时，可以通过 git-repack[1] 的 -n 选项覆盖。

在生成废弃包时，git-pack-objects[1] 使用的参数，并且未在命令行上给出相应的参数。有关默认值和含义，请参阅类似命名的 pack.* 配置变量。

当设置为 true 时，git-rerere 会使用先前记录的解决方案干净地解决冲突后，使用结果内容更新索引。默认为 false。

激活已解决冲突的记录，以便在再次遇到相同的冲突块时可以自动解决。默认情况下，如果 $GIT_DIR 下存在 rr-cache 目录（例如，如果之前在仓库中使用过“rerere”），则启用 git-rerere[1]。

将此变量设置为 true 会使 git revert 的行为如同给出了 --reference 选项。

指定 Git 将与之交互的裸仓库。当前支持的值为

这些配置条目指定 Git 跟踪的目录，即使它们由当前用户以外的人员拥有，也视为安全。默认情况下，Git 甚至会拒绝解析由其他人拥有的仓库的 Git 配置，更不用说运行其钩子了，并且此配置设置允许用户指定例外情况，例如，用于有意共享的仓库（请参阅 git-init[1] 中的 --shared 选项）。

配置标识。给出时，sendemail.<identity> 子部分中的值将优先于 sendemail 部分中的值。默认标识是 sendemail.identity 的值。

请参阅 git-send-email[1] 以获取说明。请注意，此设置不受 identity 机制的影响。

ca-certificates 的路径（目录或单个文件）。将其设置为空字符串以禁用证书验证。

下面找到的 sendemail.* 参数的特定于标识的版本，当通过命令行或 sendemail.identity 选择此标识时，将优先于这些版本。

如果为 true（默认值），则将生成一个编辑器实例来编辑您必须编辑的文件（使用 --annotate 时为补丁，使用 --compose 时为摘要）。如果为 false，则将依次编辑文件，每次生成一个新的编辑器。

设置发送前是否确认的默认值。必须是 always、never、cc、compose 或 auto 之一。有关这些值的含义，请参阅 git-send-email[1] 文档中的 --confirm。

如果为 true，则使 git-send-email[1] 假设 --mailmap，否则假设 --no-mailmap。默认为 false。

特定于 git-send-email[1] 的增强邮件映射文件的路径。首先加载默认邮件映射和 mailmap.file。因此，此文件中的条目优先于默认邮件映射位置中的条目。请参阅 gitmailmap[5]。

类似于 sendemail.mailmap.file，但将值视为对仓库中 blob 的引用。sendemail.mailmap.file 中的条目优先于此处的条目。请参阅 gitmailmap[5]。

要避免键入长的电子邮件地址，请将其指向一个或多个电子邮件别名文件。您还必须提供 sendemail.aliasFileType。

sendemail.aliasesFile 中指定的文件的格式。必须是 mutt、mailrc、pine、elm、gnus 或 sendmail 之一。