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

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

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

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

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

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

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

接受路径名值的变量可以被赋予以“~/”或“~user/”开头的字符串，并且通常的波浪号扩展会发生在这样的字符串上：~/ 被扩展为 $HOME 的值，~user/ 被扩展为指定用户的家目录。

这些变量控制各种可选的帮助消息，旨在帮助新用户。当未配置时，Git 会在说明如何消除该消息的同时给出该消息。您可以通过将这些变量设置为 false 来告诉 Git 您不需要帮助消息。

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

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

（仅限 Windows）如果为 true，则将新创建的以点开头的目录和文件标记为隐藏。如果为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。

如果为真，将使用索引的 split-index 功能。参见 git-update-index[1]。默认情况下为假。

确定如何处理索引的未跟踪缓存功能。如果此变量未设置或设置为 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` 使用平台的原生行结束符。默认值为 `native`。有关行结束符转换的更多信息，请参见 gitattributes[5]。请注意，如果 `core.autocrlf` 设置为 `true` 或 `input`，则忽略此值。

如果为真，则当启用行结束符转换时，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 for DOMAIN”格式，则该命令仅适用于以指定域字符串结尾的主机名。此变量可以设置多次，并按给定顺序匹配；第一个匹配项优先。

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

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

使用符号链接，而不是 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 不会产生任何影响。

如果为真，则此存储库被假定为裸存储库，并且没有与之关联的工作目录。如果是这种情况，一些需要工作目录的命令将被禁用，例如 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]。默认情况下为假。

如果为真，Git 会在您传递的引用名称不明确且可能与存储库中的多个引用匹配时发出警告。默认情况下为真。

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

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

在单个映射操作中映射到内存中的打包文件字节数。更大的窗口大小可能允许您的系统更快地处理更少数量的大型打包文件。更小的窗口大小会因对操作系统内存管理器的调用增加而导致性能下降，但在访问大量大型打包文件时可能会提高性能。

从 pack 文件中同时映射到内存的最大字节数。如果 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之类的命令允许您编辑消息，它们认为以该字符开头的行是注释，并在编辑器返回后将其删除（默认值为#）。

尝试锁定单个引用时重试的时长（以毫秒为单位）。 值 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，在这种情况下，将使用硬链接，然后删除源，以确保对象创建不会覆盖现有对象。

显示提交信息时，还会显示存储在指定引用中的注释。引用必须是完全限定的。如果指定的引用不存在，则不会报错，这意味着不会打印任何注释。

如果为真，则 git 会读取提交图文件（如果存在）以解析提交的图结构。默认为真。参见 git-commit-graph[1] 获取更多信息。

如果设置为 false，则表现得好像在命令行上使用了 --no-replace-objects 选项。参见 git[1] 和 git-replace[1] 获取更多信息。

使用多包索引文件来跟踪多个包文件，使用单个索引。参见 git-multi-pack-index[1] 获取更多信息。默认为真。

启用“稀疏检出”功能。参见 git-sparse-checkout[1] 获取更多信息。

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

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

Git 愿意在遍历树时递归的最大深度（例如，"a/b/cde/f" 的深度为 4）。这是一个安全措施，允许 Git 清理地中止，通常不需要调整。默认值为 4096。

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

未使用的配置变量。在 Git 版本 v2.25.0 到 v2.36.0 中使用，以启用 git-add[1] 交互模式的内置版本，该版本在 Git 版本 v2.37.0 到 v2.39.0 中成为默认值。

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

如果为真，git-am 将调用 git-mailsplit 处理 mbox 格式的补丁，并使用参数 --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]。

在 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 选项在每个分支上选择此行为。有效设置包括：false — 不进行自动设置；true — 当起始点是远程跟踪分支时进行自动设置；always — 当起始点是本地分支或远程跟踪分支时进行自动设置；inherit — 如果起始点具有跟踪配置，则将其复制到新分支；simple — 仅当起始点是远程跟踪分支且新分支与远程分支同名时进行自动设置。此选项默认为 true。

当使用 git branch、git switch 或 git checkout 创建跟踪另一个分支的新分支时，此变量告诉 Git 设置 pull 以进行变基而不是合并（参见 "branch.<name>.rebase"）。当为 never 时，变基永远不会自动设置为 true。当为 local 时，对于其他本地分支的跟踪分支，变基将设置为 true。当为 remote 时，对于远程跟踪分支的跟踪分支，变基将设置为 true。当为 always 时，对于所有跟踪分支，变基将设置为 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] 相同，但目前不支持包含空格的选项值。

当为真时，在运行 "git pull" 时，将分支 <name> 基于获取的分支进行变基，而不是合并来自默认远程的默认分支。有关以非分支特定方式执行此操作，请参见 "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 选项找到的捆绑列表文件中。如果将这些键放在仓库配置文件中，它们目前没有效果，不过这将在将来改变。有关更多详细信息，请参见 捆绑 URI 设计文档。

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

此字符串值应为 all 或 any。此值描述是否需要所有广告捆绑包才能解捆绑对捆绑信息的完整理解（all），或者是否任何一个列出的捆绑 URI 都足够（any）。

如果此字符串值键存在，则捆绑列表旨在与增量 git fetch 命令配合使用。启发式信号表明，每个捆绑包都有额外的键可用，这些键有助于确定客户端应该下载哪个捆绑包子集。目前唯一理解的值是 creationToken。

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

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

当您运行 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、-i 或 -n，否则不执行任何操作。默认为 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（显示“无分支”警告的颜色，默认为红色）、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 签名。在执行诸如变基之类的操作时使用此选项可能会导致大量提交被签名。使用代理可能很方便，以避免多次输入您的 GPG 密码。

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

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

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

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

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

如果为 true，则 git 将使用提交图文件中的更改路径布隆过滤器（如果存在，并且它们存在）。默认为 true。有关更多信息，请参见 git-commit-graph[1]。

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

获取凭据时，将 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—​守护进程忽略 SIGHUP，而不是退出。

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

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

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

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

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

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

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

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

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

设置 --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/”不同的前缀对，具体取决于比较的内容。当此配置生效时，反向差异输出也会交换前缀的顺序。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

选择一个 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 变量。

控制 git-difftool[1] 在指定 -g/--gui 标志时使用的 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，否则指定此键将导致错误。

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

如果启用，则工作树将从 $GIT_DIR/config.worktree 文件加载配置设置，此外还将从 $GIT_COMMON_DIR/config 文件加载配置设置。请注意，$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 中的底层 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 本机传输获取的对象数量低于此限制，则这些对象将被解压缩到松散的对象文件中。但是，如果接收到的对象数量等于或超过此限制，则接收到的包将在添加任何缺少的增量基础后作为包存储。从推送中存储包可以使推送操作更快完成，尤其是在速度较慢的文件系统上。如果未设置，则使用 transfer.unpackLimit 的值。

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

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

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

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

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

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

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

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

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

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

为 format-patch 启用 multipart/mixed 附件作为默认值。该值也可以是双引号字符串，它将启用附件作为默认值并将该值设置为边界。请参阅 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选项应用它们。

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

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

在 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 将打包它们。一些 Porcelain 命令使用此命令来定期执行轻量级垃圾回收。默认值为 6700。

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

如果系统支持，使 git gc --auto 立即返回并在后台运行。默认值为 true。

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

如果为真，则在运行 git-gc[1] 时，gc 会重写提交图文件。使用 git gc --auto 时，如果需要进行整理，则会更新提交图。默认值为真。有关详细信息，请参阅 git-commit-graph[1]。

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

在存储库中运行 git pack-refs 会使其无法通过 HTTP 等哑传输方式被 1.5.1.2 之前的 Git 版本克隆。此变量决定 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>”匹配的 ref。

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

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

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

在重新打包并使用过滤器时，请参阅 gc.repackFilter，指定的路径将用于创建包含过滤掉的对象的 pack 文件。警告：指定的路径应该是可访问的，例如使用 Git 备用机制，否则 Git 可能会认为仓库已损坏，因为它可能无法访问该 pack 文件中的对象。请参阅 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] 获取描述。

如果设置为 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。

在创建或验证 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)。如果在此文件中找到公钥，则它将始终被视为具有“从不”信任级别，并且签名将显示为无效。

定义 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] 手册。

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

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

仅当在 GUI 中选择了一个 diff 时才运行该工具。它保证 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]。这可以在每个远程的基础上被覆盖；参见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 通常需要用户名进行身份验证。

控制 GSSAPI 凭据委托。从 libcurl 7.21.7 版本开始，默认情况下委托被禁用。设置参数以告知服务器在用户凭据委托方面允许它做什么。与 GSS/kerberos 一起使用。可能的值是

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

包含先前存储的 cookie 行的文件的路径名，这些行应在 Git http 会话中使用，如果它们与服务器匹配。要从中读取 cookie 的文件的格式应为纯 HTTP 标头或 Netscape/Mozilla cookie 文件格式（参见 curl(1)）。请注意，使用 http.cookieFile 指定的文件仅用作输入，除非设置了 http.saveCookies。

如果设置，则将请求期间收到的 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 环境变量覆盖。

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

包含 SSL 私钥的文件，用于通过 HTTPS 获取或推送。 可以通过 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 证书存储。 由于默认情况下这是不可取的，因此 Git 会在通过 http.sslBackend 配置 schannel 后端时告诉 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。此选项允许您将此值覆盖为更常见的 value，例如 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] 的“模板目录”部分。）

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

指定将在 gitweb 中用于浏览工作存储库的程序。参见 git-instaweb[1]。

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

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

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

绑定 gitweb httpd 的端口号。参见 git-instaweb[1]。

在交互式命令中，允许用户使用单个键提供单字母输入（即，不按回车键）。目前，这由 git-add[1]、git-checkout[1]、git-restore[1]、git-commit[1]、git-reset[1] 和 git-stash[1] 的 --patch 模式使用。请注意，如果不可用可移植的按键输入，则此设置将被静默忽略；需要 Perl 模块 Term::ReadKey。

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

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

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

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

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

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

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

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

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

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

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

如果为真，则使git-log[1]、git-show[1]和git-whatchanged[1]假定--use-mailmap，否则假定--no-use-mailmap。默认情况下为真。

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

如果为真，则使git-mailinfo[1]（因此git-am[1]）默认情况下像在命令行上提供了 --scissors 选项一样工作。当此功能处于活动状态时，它会从剪刀线（即主要由“>8”、“8<”和“-”组成）之前的邮件正文中删除所有内容。

增强型邮件映射文件的路径。首先加载位于存储库根目录的默认邮件映射，然后加载此变量指向的邮件映射文件。邮件映射文件的路径可能位于存储库子目录中，或者位于存储库本身之外。请参阅git-shortlog[1]和git-blame[1]。

类似于 mailmap.file，但将值视为对存储库中 blob 的引用。如果同时给出 mailmap.file 和 mailmap.blob，则解析两者，mailmap.file 中的条目优先。在裸存储库中，这默认为 HEAD:.mailmap。在非裸存储库中，它默认为空。

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

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

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

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

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

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

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

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

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

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

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

如果 merge 命令没有指定任何提交参数，则会使用当前分支配置的 upstream 分支的最新观察值（存储在它们的远程跟踪分支中）来合并这些分支。会查询 `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。

通过将匹配集成分支名称的 glob 添加到此多值配置变量，为合并到这些集成分支而计算的默认合并消息将从其标题中省略“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 时，在操作开始之前自动创建一个临时 stash 条目，并在操作结束后应用它。这意味着您可以在脏工作树上运行 merge。但是，请谨慎使用：成功合并后最终的 stash 应用可能会导致非平凡的冲突。此选项可以被 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 无条件地使用 --auto-merge 选项与 meld 一起使用。将此值设置为 auto 使 git 检测 --auto-merge 是否受支持，并且仅在可用时使用 --auto-merge。值为 false 完全避免使用 --auto-merge，这是默认值。

vimdiff 后端使用此变量来控制其拆分窗口的显示方式。即使您使用 Neovim (nvim) 或 gVim (gvim) 作为合并工具，也适用。有关详细信息，请参阅 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，如果指定了通配符或多次指定），以便使用 git log 命令族显示提交消息。

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

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

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

当命令行上没有给出窗口大小时，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 中所有打包文件的部分内容。

If only a single pack bitmap is available, and
`pack.allowPackReuse` is set to "multi", reuse parts of just the
bitmapped packfile. This can reduce memory and CPU usage to
serve fetches, but might result in sending a slightly larger
pack. Defaults to true.

一个扩展正则表达式，用于配置一组 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 数量并相应地设置线程数。

指定默认的 pack 索引版本。有效值为 1（用于 Git 版本 1.5.2 之前的旧版 pack 索引）和 2（用于新的 pack 索引，具有对大于 4 GB 的 pack 的支持以及对损坏的 pack 的重新打包的适当保护）。版本 2 是默认值。请注意，版本 2 是强制的，并且当相应的 pack 大于 2 GB 时，此配置选项将被忽略。

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

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

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

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

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

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

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

如果为真，Git 将在位图索引（如果写入）中包含一个“查找表”部分。此表用于尽可能晚地延迟加载单个位图。这在具有相对较大的位图索引的存储库中可能会有益。默认为假。

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

如果为真，git 将为其在所有地方（除了 git-fast-import[1] 和批量签入机制中）写入的每个新包文件写入相应的 .rev 文件（参见：gitformat-pack[5]）。默认为真。

如果值为布尔值，则在写入 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"。请注意，与内置格式同名的别名将被静默忽略。

如果设置，则为所有没有明确策略的协议提供用户定义的默认策略（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。

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

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

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

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

定义 git push 在没有给出 refspec（无论是来自命令行、配置还是其他地方）时应采取的操作。不同的值适合特定的工作流程；例如，在纯粹的中心工作流程中（即获取源等于推送目标），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。将来，如果 merge 后端获得了 apply 后端的全部剩余功能，此设置可能会变得无用。

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

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

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

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

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

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

如果设置为 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-gc --auto"。你可以通过将此变量设置为 false 来停止它。

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

当 git push --signed 发送带有“nonce”的推送证书，而该“nonce”是由同一个仓库的 receive-pack 在此时间段内颁发的，则将证书中找到的“nonce”导出到 GIT_PUSH_CERT_NONCE 环境变量中（而不是 receive-pack 要求发送方包含的“nonce”）。这可能使在 pre-receive 和 post-receive 中编写检查变得更容易。他们不再需要检查 GIT_PUSH_CERT_NONCE_SLOP 环境变量（记录 nonce 过期了多少秒）来决定是否接受证书，而只需要检查 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 将拒绝对非裸仓库当前签出分支的引用更新。这种推送可能很危险，因为它会导致 HEAD 与索引和工作树不同步。如果设置为 "warn"，则会将此类推送的警告打印到 stderr，但允许推送继续进行。如果设置为 false 或 "ignore"，则允许此类推送，不显示任何消息。默认值为 "refuse"。

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

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

这是一个多值变量，用于定义引用前缀以匹配 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 接收数据并更新引用后运行 git-update-server-info。

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

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

远程仓库的 URL。参见 git-fetch[1] 或 git-push[1]。

远程仓库的推送 URL。参见 git-push[1]。

对于需要 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 选项。

如果为 true，则使用 git-fetch[1] 或 git-remote[1] 的 update 子命令更新时，默认情况下将跳过此远程仓库。

如果为 true，则使用 git-fetch[1] 或 git-remote[1] 的 update 子命令更新时，默认情况下将跳过此远程仓库。

推送时远程端执行的默认程序。参见 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 选项覆盖。

在生成 cruft 包时由 git-pack-objects[1] 使用的参数，以及在命令行中未给出相应参数时的参数。有关默认值和含义，请参见类似命名的 pack.* 配置变量。

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

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

将此变量设置为 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 选择此身份时，优先于这些版本。

如果为真（默认），将生成一个编辑器实例来编辑您必须编辑的文件（使用 --annotate 时为补丁，使用 --compose 时为摘要）。如果为假，将一个接一个地编辑文件，每次都生成一个新的编辑器。

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

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

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

这些配置变量都为 git-send-email[1] 命令行选项提供默认值。有关详细信息，请参阅其文档。

sendemail.signedoffbycc 的已弃用别名。

每次连接要发送的消息数量，之后将重新登录。如果值为 0 或未定义，则在一个连接中发送所有消息。另请参阅 git-send-email[1] 的 --batch-size 选项。

重新连接到 smtp 服务器之前等待的秒数。另请参阅 git-send-email[1] 的 --relogin-delay 选项。

为了避免常见的错误配置，git-send-email[1] 会在存在任何“sendmail”的配置选项时发出警告并中止。设置此变量以绕过检查。

git rebase -i 用于编辑变基指令文件的文本编辑器。该值旨在在 shell 使用时被解释。它可以被 GIT_SEQUENCE_EDITOR 环境变量覆盖。如果未配置，则使用默认的提交消息编辑器。

git-show-branch[1] 的默认分支集。请参阅 git-show-branch[1]。

通常，使用稀疏检出时，与任何稀疏模式不匹配的文件将在索引中标记为 SKIP_WORKTREE 位，并且在工作树中不存在。因此，Git 通常会检查具有 SKIP_WORKTREE 位的文件是否实际上存在于工作树中，这与预期相反。如果 Git 发现任何文件，它会通过清除相关的 SKIP_WORKTREE 位来标记这些路径为存在。此选项可用于告诉 Git 这些存在但被跳过的文件是预期的，并停止检查它们。

当使用拆分索引功能时，此选项指定拆分索引中可以包含的条目百分比，与拆分索引和共享索引中所有条目的总数相比，在写入新的共享索引之前。该值应介于 0 和 100 之间。如果该值为 0，则始终写入新的共享索引；如果该值为 100，则永远不会写入新的共享索引。默认情况下，该值为 20，因此如果拆分索引中的条目数量超过条目总数的 20%，则会写入新的共享索引。请参阅 git-update-index[1]。

当使用拆分索引功能时，自此变量指定的时间以来未修改的共享索引文件将在创建新的共享索引文件时被删除。值 "now" 会立即使所有条目失效，而 "never" 会完全禁止失效。默认值为 "2.weeks.ago"。请注意，每次基于共享索引文件创建新的拆分索引文件或从共享索引文件读取数据时，共享索引文件都会被视为已修改（出于失效目的）。请参阅 git-update-index[1]。

默认情况下，Git 会根据配置的 SSH 命令的基名（使用环境变量 GIT_SSH 或 GIT_SSH_COMMAND 或配置设置 core.sshCommand 配置）确定要使用的命令行参数。如果基名无法识别，Git 会尝试通过首先使用 -G（打印配置）选项调用配置的 SSH 命令来检测对 OpenSSH 选项的支持，然后将使用 OpenSSH 选项（如果成功）或除了主机和远程命令之外没有其他选项（如果失败）。

默认情况下，git-status[1] 显示相对于当前目录的路径。将此变量设置为 false 将显示相对于仓库根目录的路径（这是 Git 在 v1.5.4 之前的默认设置）。

设置为 true 以在 git-status[1] 中默认启用 --short。选项 --no-short 优先于此变量。

设置为 true 以在 git-status[1] 中默认启用 --branch。选项 --no-branch 优先于此变量。

设置为 true 以在 git-status[1] 中默认启用 --ahead-behind，设置为 false 以默认启用 --no-ahead-behind，用于非瓷器状态格式。默认为 true。

如果设置为 true，git-status[1] 将在每行输出之前插入一个注释前缀（以 core.commentChar 开头，即默认情况下为 #）。这是 git-status[1] 在 Git 1.8.4 及之前版本中的行为。默认为 false。

在 git-status[1] 和 git-commit[1] 中执行重命名检测时要考虑的文件数量。默认为 diff.renameLimit 的值。

Git 在 git-status[1] 和 git-commit[1] 中是否以及如何检测重命名。如果设置为 "false"，则禁用重命名检测。如果设置为 "true"，则启用基本重命名检测。如果设置为 "copies" 或 "copy"，Git 将检测复制。默认为 diff.renames 的值。

如果设置为 true，git-status[1] 将显示当前存储的条目数量。默认为 false。

默认情况下，git-status[1] 和 git-commit[1] 会显示当前未被 Git 跟踪的文件。仅包含未跟踪文件的目录，仅显示目录名称。显示未跟踪文件意味着 Git 需要对整个仓库中的所有文件进行 lstat() 操作，这在某些系统上可能很慢。因此，此变量控制命令如何显示未跟踪文件。可能的值为

默认为 false。如果将其设置为非零数字或 true（与 -1 或无限数量相同），则子模块摘要将被启用，并将显示修改后的子模块的提交摘要（请参阅 git-submodule[1] 的 --summary-limit 选项）。请注意，当 diff.ignoreSubmodules 设置为 all 时，或仅对 submodule.<name>.ignore=all 的子模块，摘要输出命令将被抑制。该规则的唯一例外是，状态和提交将显示暂存的子模块更改。要查看被忽略子模块的摘要，可以使用 --ignore-submodules=dirty 命令行选项或 git submodule summary 命令，该命令显示类似的输出，但不遵守这些设置。

如果将其设置为 true，git stash show 命令将显示存储条目中的未跟踪文件。默认为 false。请参阅 git-stash[1] 中 show 命令的描述。

如果将其设置为 true，则没有选项的 git stash show 命令将以补丁形式显示存储条目。默认为 false。请参阅 git-stash[1] 中 show 命令的描述。

如果设置为 true，则不带选项的 git stash show 命令将显示存储条目 的 diffstat。默认为 true。有关 show 命令的描述，请参见 git-stash[1]。

子模块的 URL。此变量从 .gitmodules 文件复制到 git 配置中，通过 git submodule init。用户可以在通过 git submodule update 获取子模块之前更改配置的 URL。如果既没有设置 submodule.<name>.active 也没有设置 submodule.active，则此变量的存在将用作回退，以指示子模块是否对 git 命令感兴趣。有关详细信息，请参见 git-submodule[1] 和 gitmodules[5]。

子模块由 git submodule update 更新的方法，这是唯一受影响的命令，其他命令（如 git checkout --recurse-submodules）不受影响。它存在于历史原因，当时 git submodule 是唯一与子模块交互的命令；submodule.active 和 pull.rebase 等设置更具体。它由 git submodule init 从 gitmodules[5] 文件填充。有关 update 命令的描述，请参见 git-submodule[1]。

子模块的远程分支名称，由 git submodule update --remote 使用。设置此选项以覆盖在 .gitmodules 文件中找到的值。有关详细信息，请参见 git-submodule[1] 和 gitmodules[5]。

此选项可用于控制此子模块的递归获取。可以通过对“git fetch”和“git pull”使用 --[no-]recurse-submodules 命令行选项来覆盖它。此设置将覆盖 gitmodules[5] 文件中的设置。

定义在什么情况下“git status”和 diff 族将子模块显示为已修改。当设置为“all”时，它永远不会被认为是已修改的（但它仍然会在已暂存时显示在 status 和 commit 的输出中），“dirty”将忽略对子模块工作树的所有更改，并且只考虑子模块的 HEAD 与超级项目中记录的提交之间的差异。“untracked”将另外让工作树中具有修改过的跟踪文件的子模块显示出来。使用“none”（当未设置此选项时的默认值）还会将工作树中具有未跟踪文件的子模块显示为已更改。此设置将覆盖在 .gitmodules 中对该子模块进行的任何设置，这两个设置都可以在命令行上通过使用“--ignore-submodules”选项来覆盖。git submodule 命令不受此设置的影响。

布尔值，指示子模块是否对 git 命令感兴趣。此配置选项优先于 submodule.active 配置选项。有关详细信息，请参见 gitsubmodules[7]。

一个重复字段，包含一个路径模式，用于匹配子模块的路径，以确定子模块是否与 git 命令相关。有关详细信息，请参阅 gitsubmodules[7]。

一个布尔值，指示命令是否默认启用 --recurse-submodules 选项。默认值为 false。

[实验性] 一个布尔值，在使用 --recurse-submodules 或 submodule.recurse=true 时启用分支支持。启用此选项将允许某些命令接受 --recurse-submodules，并且某些已经接受 --recurse-submodules 的命令现在将考虑分支。默认值为 false。

指定同时获取/克隆多少个子模块。正整数允许最多指定数量的子模块并行获取。值为 0 将给出一些合理的默认值。如果未设置，则默认为 1。

指定子模块在克隆时如何获取备用。可能的值为 no、superproject。默认情况下，假设为 no，它不会添加引用。当值为 superproject 时，要克隆的子模块会相对于超级项目的备用计算其备用位置。

指定如何处理通过submodule.alternateLocation计算的子模块备用项的错误。可能的值为ignore、info、die。默认值为die。请注意，如果设置为ignore或info，并且计算的备用项存在错误，则克隆将继续进行，就好像没有指定备用项一样。

一个布尔值，用于指定是否应对创建的带注释标签进行 GPG 签名。如果在命令行上指定了--annotate，则它优先于此选项。

此变量控制 git-tag[1] 显示标签时的排序顺序。如果没有提供“--sort=<value>”选项，则此变量的值将用作默认值。

一个布尔值，用于指定是否应为所有标签进行 GPG 签名。在自动化脚本中使用此选项会导致大量标签被签名。因此，使用代理来避免多次输入您的 gpg 密码会很方便。请注意，此选项不会影响由“-u <keyid>”或“--local-user=<keyid>”选项启用的标签签名行为。

此变量可用于限制 tar 归档条目权限位。默认值为 0002，它会关闭世界写入位。特殊值“user”表示将使用归档用户的 umask。请参阅 umask(2) 和 git-archive[1]。

此变量控制正常目标目的地。它可以被GIT_TRACE2环境变量覆盖。下表显示了可能的值。

此变量控制性能目标目的地。它可以被GIT_TRACE2_PERF环境变量覆盖。下表显示了可能的值。

此变量控制事件目标目的地。它可以被GIT_TRACE2_EVENT环境变量覆盖。下表显示了可能的值。

布尔值。如果为真，则从正常输出中省略 time、filename 和 line 字段。可以被 GIT_TRACE2_BRIEF 环境变量覆盖。默认为 false。

布尔值。如果为真，则从 PERF 输出中省略 time、filename 和 line 字段。可以被 GIT_TRACE2_PERF_BRIEF 环境变量覆盖。默认为 false。

布尔值。如果为真，则从事件输出中省略 time、filename 和 line 字段。可以被 GIT_TRACE2_EVENT_BRIEF 环境变量覆盖。默认为 false。

整数。指定事件输出中嵌套区域的所需深度。比此值更深的区域将被省略。可以被 GIT_TRACE2_EVENT_NESTING 环境变量覆盖。默认为 2。

一个逗号分隔的“重要”配置设置模式列表，这些模式应记录在 trace2 输出中。例如，core.*,remote.*.url 将导致 trace2 输出包含列出每个配置的远程的事件。可以被 GIT_TRACE2_CONFIG_PARAMS 环境变量覆盖。默认情况下未设置。

一个逗号分隔的“重要”环境变量列表，这些变量应记录在 trace2 输出中。例如，GIT_HTTP_USER_AGENT,GIT_CONFIG 将导致 trace2 输出包含列出 HTTP 用户代理的覆盖和 Git 配置文件的位置的事件（假设有任何设置）。可以被 GIT_TRACE2_ENV_VARS 环境变量覆盖。默认情况下未设置。

布尔值。如果为真，Git 将在无法打开跟踪目标目的地以写入时打印错误消息。默认情况下，这些错误会被抑制，跟踪会静默禁用。可以被 GIT_TRACE2_DST_DEBUG 环境变量覆盖。

整数。当将跟踪文件写入目标目录时，如果这样做会导致超过此数量的文件，则不要写入其他跟踪。相反，写入一个哨兵文件，该文件将阻止进一步跟踪到此目录。默认为 0，这将禁用此检查。

配置的 URL 可以包含明文凭据，格式为 <protocol>://<user>:<password>@<domain>/<path>。您可能希望警告或禁止使用此类配置（建议使用 git-credential[1]）。这将用于 git-clone[1]、git-fetch[1]、git-push[1] 以及任何其他直接使用配置 URL 的操作。

当 fetch.fsckObjects 或 receive.fsckObjects 未设置时，将使用此变量的值。默认为 false。

receive-pack 和 upload-pack 使用的字符串，用于决定从其初始广告中省略哪些引用。使用多个定义来指定多个前缀字符串。在该变量的值中列出的层次结构下的引用将被排除，并在响应 git push 或 git fetch 时被隐藏。有关此配置的特定于程序的版本，请参见 receive.hideRefs 和 uploadpack.hideRefs。

当 fetch.unpackLimit 或 receive.unpackLimit 未设置时，将使用此变量的值。默认值为 100。

布尔值。当为真时，客户端和服务器进程会将其唯一的会话 ID 公告给远程对应方。默认为 false。

当 true 时，本地 git clone 命令将从远程服务器请求捆绑信息（如果已广告）并在通过 Git 协议继续克隆之前下载捆绑包。默认为 false。

如果为真，则允许客户端使用 git archive --remote 请求任何树，无论它是否可以从 ref 尖端访问。有关更多详细信息，请参阅 git-upload-archive[1] 的“安全”部分中的讨论。默认为 false。

此变量与 transfer.hideRefs 相同，但仅适用于 upload-pack（因此仅影响获取，不影响推送）。尝试通过 git fetch 获取隐藏的 ref 将失败。另请参阅 uploadpack.allowTipSHA1InWant。

当 uploadpack.hideRefs 生效时，允许 upload-pack 接受请求隐藏 ref 尖端对象（默认情况下，此类请求将被拒绝）的获取请求。另请参阅 uploadpack.hideRefs。即使这是 false，客户端也可能能够通过 gitnamespaces[7] 手册页“安全”部分中描述的技术窃取对象；最好将私有数据保存在单独的存储库中。

允许upload-pack接受一个请求，该请求要求获取从任何引用顶端可达的对象。但是，请注意，计算对象可达性在计算上很昂贵。默认值为false。即使此值为 false，客户端也可能通过在gitnamespaces[7] 手册页的“安全性”部分中描述的技术来窃取对象；最好将私有数据保存在单独的存储库中。

允许upload-pack接受一个请求，该请求要求获取任何对象。默认值为false。

当upload-pack启动pack-objects时，可能会有一个安静的时期，在此期间pack-objects准备打包。通常它会输出进度信息，但如果--quiet用于获取，pack-objects在打包数据开始之前将完全不输出任何内容。某些客户端和网络可能会认为服务器已挂起并放弃。设置此选项指示upload-pack每uploadpack.keepAlive秒发送一个空的保持活动数据包。将此选项设置为 0 将完全禁用保持活动数据包。默认值为 5 秒。

如果设置了此选项，当upload-pack运行git pack-objects为客户端创建打包文件时，它将改为运行此 shell 命令。它将运行的pack-objects命令和参数（包括开头的git pack-objects）将附加到 shell 命令。钩子的 stdin 和 stdout 被视为pack-objects本身运行。即，upload-pack将为pack-objects提供输入到钩子，并期望在 stdout 上获得一个完成的打包文件。

如果设置了此选项，upload-pack将支持部分克隆和部分获取对象过滤。

为未指定的对象过滤器提供默认值（参见：下面的配置变量）。如果设置为 true，这也会启用将来添加的所有过滤器。默认值为 true。

显式允许或禁止与 <filter> 对应的对象过滤器，其中 <filter> 可以是以下之一：blob:none、blob:limit、object:type、tree、sparse:oid 或 combine。如果使用组合过滤器，则 combine 和所有嵌套过滤器类型都必须被允许。默认值为 uploadpackfilter.allow。

仅当 <n> 不大于 uploadpackfilter.tree.maxDepth 的值时，才允许 --filter=tree:<n>。如果设置，这也意味着 uploadpackfilter.tree.allow=true，除非此配置变量已被设置。如果未设置，则无效。

如果设置了此选项，upload-pack 将支持协议版本 2 fetch 命令的 ref-in-want 功能。此功能旨在有利于负载均衡服务器，这些服务器可能由于复制延迟而对它们的 ref 指向的 OID 具有不同的视图。

任何以该值开头的 URL 将被重写为以 <base> 开头。在某些站点提供大量存储库并使用多种访问方法提供这些存储库的情况下，一些用户需要使用不同的访问方法，此功能允许人们指定任何等效 URL 并让 Git 自动将 URL 重写为特定用户最佳的替代方案，即使对于站点上从未见过的存储库也是如此。当多个 insteadOf 字符串匹配给定 URL 时，将使用最长的匹配项。

任何以该值开头的 URL 不会被推送到；相反，它将被重写为以 <base> 开头，并将推送到生成的 URL。在某些站点提供大量存储库并使用多种访问方法提供这些存储库的情况下，其中一些方法不允许推送，此功能允许人们指定一个仅拉取的 URL 并让 Git 自动使用适当的 URL 推送，即使对于站点上从未见过的存储库也是如此。当多个 pushInsteadOf 字符串匹配给定 URL 时，将使用最长的匹配项。如果远程具有显式 pushurl，Git 将忽略此设置。

user.name 和 user.email 变量决定了最终出现在提交对象 author 和 committer 字段中的内容。如果您需要 author 或 committer 不同，则可以设置 author.name、author.email、committer.name 或 committer.email 变量。所有这些都可以被 GIT_AUTHOR_NAME、GIT_AUTHOR_EMAIL、GIT_COMMITTER_NAME、GIT_COMMITTER_EMAIL 和 EMAIL 环境变量覆盖。

指示 Git 避免尝试猜测 user.email 和 user.name 的默认值，而是仅从配置中检索这些值。例如，如果您有多个电子邮件地址，并且希望在每个存储库中使用不同的地址，那么在全局配置中将此配置选项设置为 true 以及一个名称后，Git 会在您在克隆的存储库中进行新的提交之前提示您设置电子邮件。默认值为 false。

如果 git-tag[1] 或 git-commit[1] 在创建签名标签或提交时没有自动选择您想要的密钥，您可以使用此变量覆盖默认选择。此选项将原样传递给 gpg 的 --local-user 参数，因此您可以使用 gpg 支持的任何方法指定密钥。如果 gpg.format 设置为 ssh，则此选项可以包含您私有 ssh 密钥的路径或 ssh-agent 使用的公钥。或者，它可以包含以 key:: 为前缀的公钥（例如：“key::ssh-rsa XXXXXX identifier”）。私钥需要通过 ssh-agent 提供。如果没有设置，Git 将调用 gpg.ssh.defaultKeyCommand（例如：“ssh-add -L”）并尝试使用第一个可用的密钥。为了向后兼容，以 "ssh-" 开头的原始密钥，例如 "ssh-rsa XXXXXX identifier"，将被视为 "key::ssh-rsa XXXXXX identifier"，但这种形式已弃用；请改用 key:: 形式。

versionsort.suffix 的已弃用别名。如果设置了 versionsort.suffix，则忽略此选项。

即使在 git-tag[1] 中使用版本排序，具有相同基本版本但不同后缀的标签名仍然按字典顺序排序，导致例如预发布标签出现在主发布之后（例如 "1.0-rc1" 在 "1.0" 之后）。此变量可以指定来确定具有不同后缀的标签的排序顺序。

指定一些命令可能使用的 Web 浏览器。目前只有 git-instaweb[1] 和 git-help[1] 可能使用它。

如果没有指定分支，并且没有使用 -b、-B 或 --detach，则 git worktree add 默认从 HEAD 创建一个新分支。如果 worktree.guessRemote 设置为 true，worktree add 会尝试找到一个远程跟踪分支，其名称与新分支名称唯一匹配。如果存在这样的分支，它将被检出并设置为新分支的 "upstream"。如果找不到这样的匹配项，它将回退到从当前 HEAD 创建一个新分支。