关键字 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 将提供消息以及如何抑制它的说明。您可以通过将相应变量设置为 false 来告诉 Git 您已理解问题并且不再需要特定的帮助消息。

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

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

默认情况下，如果补丁不能干净应用，git am 将失败。当设置为 true 时，此设置告诉 git am 如果补丁记录了它应该应用的 blob 的身份并且我们本地有这些 blob 可用，则回退到三向合并（等同于从命令行提供 --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。

这决定了应用于 blame 输出的着色方案。它可以是 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 选项为每个分支选择此行为。此选项默认为 true。有效设置为

当使用 git branch、git switch 或 git checkout 创建跟踪另一个分支的新分支时，此变量告诉 Git 设置 pull 为 rebase 而不是 merge（请参阅 branch.<name>.rebase）。有效设置为

此变量控制 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 默认的 refspec 以在 FETCH_HEAD 中标记为合并。该值像 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] 相同，但目前不支持包含空格字符的选项值。

当为 true 时，在运行 git pull 时，将分支 <name> rebase 到已获取的分支之上，而不是合并默认远程的默认分支。有关以非分支特定方式执行此操作的信息，请参阅 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。此值描述是否需要所有 advertised bundles 才能完整理解 bundled 信息（all），或者是否任何列出的 bundle URI 都足够（any）。

如果存在此字符串值键，则 bundle 列表旨在与增量 git fetch 命令良好协作。heuristic 表示每个 bundle 都有额外的键可用，这些键有助于确定客户端应下载哪个 bundle 子集。目前唯一理解的值是 creationToken。

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

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

当您运行 git checkout <something> 或 git switch <something> 且只有一个远程时，它可能会隐式地回退到签出和跟踪 e.g. origin/<something>。一旦您有多个具有 *<something>* 引用的远程，这种情况就会停止工作。此设置允许设置一个首选远程的名称，该名称在歧义化时应始终优先。典型用例是将其设置为 origin。

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

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

当使用少量文件进行并行 checkout 时，子进程生成和进程间通信的成本可能会超过并行化的收益。此设置允许您定义应尝试并行 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（其他引用）之一。

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

对 diff 着色使用自定义颜色。<slot> 指定补丁的哪个部分使用指定颜色，它是 context（上下文文本 - plain 是历史同义词）、meta（元信息）、frag（ hunk 头）、func（ hunk 头中的函数）、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（显示“无分支”警告的颜色，默认为红色）、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]。当您始终希望在日志消息中保留以注释字符（core.commentChar，默认为 #）开头的行时，更改默认值可能很有用，在这种情况下，您将执行 git config commit.cleanup whitespace（请注意，如果这样做，您必须自己删除提交日志模板中以注释字符开头的帮助行）。

一个布尔值，用于指定是否应 GPG 签名所有提交。在 rebase 等操作中使用此选项可能导致大量提交被签名。使用代理可能很方便，以避免多次输入 GPG 密码。

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

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

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

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

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

如果为 true，则 git commit-graph write 默认将计算并写入 changed-path 布隆过滤器，等同于传递 --changed-paths。如果为 false 或未设置，则仅当过滤器已存在于当前提交图文件中时，才会在 git commit-graph write 期间写入 changed-path 布隆过滤器。这与不带任何 --[no-]changed-paths 选项的 git commit-graph write 的默认行为匹配。要重写不带任何过滤器的提交图文件，请使用 --no-changed-paths 选项。命令行选项 --[no-]changed-paths 始终优先于此配置。默认为未设置。

已废弃。如果为 true，则等同于 commitGraph.changedPathsVersion=-1；如果为 false，则等同于 commitGraph.changedPathsVersion=0。（如果 commitGraph.changedPathVersion 也已设置，则 commitGraph.changedPathsVersion 优先。）

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

这仅由 git-completion.bash 使用，用于从已完成命令列表中添加或删除命令。通常只完成 porcelain 命令和少数几个其他命令。您可以在此变量中添加更多命令，用空格分隔。命令前加上 - 将从现有列表中删除它。

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

（仅限 Windows）如果为 true，则将新建的以点开头的目录和文件标记为隐藏。如果为 dotGitOnly，则仅隐藏 .git/ 目录，但不隐藏其他以点开头的文件。默认模式为 dotGitOnly。

内部变量，启用各种变通方法，使 Git 在不区分大小写的文件系统（如 APFS、HFS+、FAT、NTFS 等）上更好地工作。例如，如果目录列表找到 "makefile" 而 Git 期望 "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]）。

设置调用 "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 语言转义控制字符（例如 TAB 的 \t、LF 的 \n、反斜杠的 \\）相同的方式转义这些字符，或字节值大于 0x80（例如 UTF-8 中“微”的八进制 \302\265）来引用路径名中的“不寻常”字符。如果此变量设置为 false，则大于 0x80 的字节不再被视为“不寻常”。双引号、反斜杠和控制字符始终被转义，无论此变量的设置如何。简单的空格字符不被视为“不寻常”。许多命令可以使用 -z 选项完全按原样输出路径名。默认值为 true。

设置工作目录中用于标记为文本的文件（通过设置 text 属性，或通过 text=auto 和 Git 自动检测内容为文本）的行尾类型。备选项包括 lf、crlf 和 native，其中 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，则当前工作目录被视为工作树的顶层。

启用引用日志。对引用 <ref> 的更新将被记录到文件 "$GIT_DIR/logs/<ref>" 中，通过附加新旧 SHA-1、日期/时间和更新原因，但仅当文件存在时。如果此配置变量设置为 true，则会自动为分支头（即 refs/heads/ 下）、远程引用（即 refs/remotes/ 下）、注释引用（即 refs/notes/ 下）和符号引用 HEAD 创建缺失的 "$GIT_DIR/logs/<ref>" 文件。如果设置为 always，则会自动为 refs/ 下的任何引用创建缺失的引用日志。

标识仓库格式和布局版本的内部变量。请参阅 gitrepository-layout[5]。

当为 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 的引用名称模糊且可能与仓库中的多个引用匹配，Git 将警告您。默认为 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 之外，指定包含属性（参见 gitattributes[5]）的文件路径。其默认值为 $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 解释器的事实。

您可以将其设置为 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]。

启用稀疏检出功能的“锥形模式”。当 sparse-checkout 文件包含有限的模式集时，此模式提供了显著的性能优势。可以通过将此变量设置为 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]。

默认情况下，作为密码提示一部分显示的用户名和主机不允许包含控制字符（它们默认将被 URL 编码）。将此设置配置为 false 以覆盖该行为。

默认情况下，当 Git 与凭据助手通信时，协议中不允许包含回车符。此设置允许用户覆盖此默认值。

如果未为网络身份验证设置用户名，则默认使用此用户名。请参阅下面的 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 命令，而不影响 git diff-files 等低级 diff 命令。

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

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

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

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

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

如果设置了此配置变量，则差异生成不使用内部差异机制执行，而是使用给定的命令执行。可以使用 GIT_EXTERNAL_DIFF 环境变量覆盖。该命令将以 git[1] 中“git 差异”所述的参数调用。注意：如果您只想在部分文件上使用外部差异程序，您可能希望使用 gitattributes[5]。

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

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

如果设置，git diff 会根据正在比较的内容使用不同于标准 a/ 和 b/ 的前缀对。当此配置生效时，反向差异输出也会交换前缀的顺序。

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

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

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

如果设置为 true，git 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 Porcelain 差异命令，而不影响 git-diff-files[1] 等低级命令。

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

指定子模块差异的显示格式。short 格式只显示范围开始和结束时的提交名称。log 格式像 git-submodule[1] summary 一样列出范围内的提交。diff 格式显示子模块更改内容的内联差异。默认为 short。

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

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

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

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

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

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

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

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

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

选择一种差异算法。变体如下：

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

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

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

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

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

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

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

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

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

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

除非另有说明，如果 core.repositoryFormatVersion 不是 1，则指定扩展是错误的。请参阅 gitrepository-layout[5]。

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

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

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

启用配置选项，这些选项针对工作目录中文件数量众多的仓库进行优化。文件数量众多时，git status 和 git checkout 等命令可能很慢，这些新默认值可以提高性能：

此选项控制 git fetch（以及 git pull 中的底层 fetch）是否递归地抓取到已填充的子模块中。此选项可以设置为布尔值或 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 的值。

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

如果为 true，并且尚未设置，则 fetch 将在修剪时自动表现得像提供了 refs/tags/*:refs/tags/* refspec。这允许设置此选项和 fetch.prune 以保持与上游引用的一对一映射。另请参阅 remote.<name>.pruneTags 和 git-fetch[1] 的 PRUNING 部分。

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

控制如何打印引用更新状态。有效值为 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 选项的行为。git clone --bundle-uri 如果提供的捆绑 URI 包含一个为增量获取组织的捆绑列表，则会设置 fetch.bundleURI 值。

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

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

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

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

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

为 format-patch 的 --[no-]force-in-body-from 选项提供默认值。默认为 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 时，它启用健壮的“mboxrd”格式来转义“^>+From”行。

如果设置，则在补丁中不显示任何源或目标前缀。这相当于 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 使用的 delta 压缩算法中的深度参数。这默认为 50，这是未在使用 --aggressive 时 --depth 选项的默认值。

git gc --aggressive 使用的 delta 压缩算法中的窗口大小参数。这默认为 250，这是一个比默认 --window 10 更激进的窗口大小。

当仓库中松散对象的数量大约超过此值时，git gc --auto 将打包它们。一些 Porcelain 命令会不时使用此命令执行轻量级垃圾回收。默认值为 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 将重写提交图文件。当使用 git gc --auto 时，如果需要进行维护，提交图将被更新。默认为 true。详细信息请参阅 git-commit-graph[1]。

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

在仓库中运行 git pack-refs 会导致早期于 1.5.1.2 版本的 Git 无法通过 dumb 传输（如 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> 匹配的引用。

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

在考虑是否删除对象时（无论是生成垃圾包还是将不可达对象存储为松散对象），使用 shell 执行指定的命令。将其输出解释为 Git 将视为“最近”的对象 ID，无论其年龄如何。通过将其 mtimes 视为“现在”，输出中提到的任何对象（及其后代）都将被保留，无论其真实年龄如何。

重新打包时，使用指定的过滤器将某些对象移动到单独的包文件中。请参阅 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]。

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

如果 gitcvs.usecrlfattr 未解析出正确的 -kb 模式，则使用此选项。如果为 true，所有未解析的文件都以 -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 签名时，代替“gpg”使用的程序的路径名。该程序必须支持与 GPG 相同的命令行接口，即，要验证分离签名，运行“gpg --verify $signature - <$file”，并且程序预计通过退出代码 0 来表示良好的签名。要生成 ASCII-armored 分离签名，将要签名的内容提供给“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 信任的密钥。设置此选项会覆盖所有操作所需的信任级别。支持的值，按重要性递增的顺序排列