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

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

关键词 onbranch: ` 后面的数据被认为是一个带有标准通配符和两个额外的通配符的模式，**/` 和 /**，可以匹配多个路径组件。 如果我们在一个工作区中，当前检出的分支的名称与该模式相匹配，则满足包含条件。

这个关键词后面的数据被认为是一个带有标准的通配符和两个额外的通配符的模式，**/ 和 /**，可以匹配多个组件。第一次看到这个关键词时，其余的配置文件将被扫描以寻找远程 URL（不应用任何值）。如果存在至少一个匹配该模式的远程 URL，则满足包含条件。

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

许多指定各种尺寸的变量的值可以以 k、M…​为后缀，表示 “以1024为比例的数字”、“以1024x1024为比例”，等等。

接受颜色的变量的值是一个颜色（最多两个，一个用于前景，一个用于背景）和属性（你想要多少就有多少）的列表，用空格分隔。

一个获取路径名值的变量可以被赋予一个以 "~/" 或 "~user/" 开头的字符串，通常的 tilde 扩展会发生在这样一个字符串上： ~/ 被扩展为 $HOME 的值，而 ~user/ 被扩展为指定用户的主目录。

当某些文件由于索引错误而无法添加时，使用 git add 以继续添加文件。 等同于 git-add[1] 的 --ignore-errors 选项。 add.ignore-errors 已经被弃用， 因为它不符合配置变量的常规命名约定。

告诉 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 覆盖。如果未配置远程，或者当前不在任何分支上且仓库中定义了多个远程，则 fetch 默认使用 origin，push 默认使用 remote.pushDefault。另外，.（句点）表示当前本地仓库（点仓库），见下文 branch.<name>.merge 的最后说明。

当位于分支 <name> 上时，它会在推送时覆盖 branch.<name>.remote。它也会在从分支 <name> 推送时覆盖 remote.pushDefault。当你从一个地方拉取（例如上游仓库）而向另一个地方推送（例如自己的发布仓库）时，可以使用 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。指定多个值可得到 octopus merge。若你希望把 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 的摘要中。

当你运行 git checkout <something> 或 git switch <something>，且只有一个远程时，它可能会隐式回退为检出并跟踪例如 origin/<something>。但一旦存在多个都带有 <something> 引用的远程，这种做法就不再有效。该设置允许指定一个首选远程名称，在发生歧义时始终优先选择它。典型用法是将其设为 origin。

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

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

当对少量文件执行并行 checkout 时，创建子进程和进程间通信的成本可能会超过并行化带来的收益。该设置允许你定义应尝试并行 checkout 的最小文件数。默认值为 100。

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

如果是浅层仓库，则拒绝克隆；可以通过在命令行中传递 --reject-shallow 选项来重写。 参见 git-clone[1].

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

此设置会覆盖 git commit 中 --cleanup 选项的默认值。See git-commit[1] for details. 当你总是希望在日志消息中保留以注释字符（core.commentChar，默认值为 #）开头的行时，更改默认值会很有用；此时你可以执行 git config commit.cleanup whitespace（注意，如果这样做，你必须自行删除提交日志模板中以该注释字符开头的帮助行）。

布尔值，用于指定是否对所有提交进行 GPG 签名。在进行变基等操作时使用该选项可能会导致大量提交被签名。使用代理可以避免多次键入 GPG 密码。

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

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

一个布尔值或 int 值，用于指定 git commit 的详细程度。See git-commit[1] for details.

在使用 git diff 与工作区文件进行比较时，不要将仅统计信息的更改视为已更改。取而代之的是静默运行 git update-index --refresh 来更新工作区中内容与索引中内容匹配的路径的缓存统计信息。该选项默认为 true。请注意，这只会影响 git diff 命令，而不会影响更低级的 diff 命令，比如 git diff-files。

逗号分隔的 --dirstat 参数列表，用于定义 git diff （见 Git 文档中的 git-diff[1] 部分） 及其相关命令中 --dirstat 选项的默认工作方式 这些参数决定了在执行差异比较时，如何统计和展示目录变化的信息。 以逗号分隔的 --dirstat 参数列表，用于指定 git-diff[1] 和友集的 --dirstat 选项的默认行为。 默认值可以在命令行中覆盖（使用 --dirstat=<参数1,参数2,...>）。 后备默认值（当 diff.dirstat 没有更改时）是 changes,noncumulative,3 。 以下参数可用：

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

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

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

显示 diff hunk 之间的上下文，行数不超过指定行数，从而合并彼此相近的 hunk。此值是 --inter-hunk-context 命令行选项的默认值。

如果设置了该配置变量，则不会使用内部 diff 机制生成 diff，而是使用给定的命令。可以用 GIT_EXTERNAL_DIFF 环境变量来覆盖。该命令的参数调用方式与 git[1] 中 "git Diffs" 一节所述相同。注意：如果只想在部分文件上使用外部差异程序，可以用 gitattributes[5] 代替。

如果这个布尔值设置为 true，那么 diff.external 命令被期望在认为输入文件相等时返回退出码 0，在认为它们不同时返回退出码 1，类似于 diff(1)。如果它被设置为默认值 false，那么期望该命令无论文件是否相等都返回退出码 0。任何其他的退出码都会导致 Git 报告一个致命错误。

设置 --ignore-submodules 的默认值。请注意，这只会影响上层命令 git diff，而不会影响更底层的 diff 命令，如 git diff-files。git checkout 和 git switch 在报告未提交的改动时也会尊重这一设置。如果将其设置为 all，则 git commit 和 git status 在设置 status.submoduleSummary 时通常会显示子模块摘要，除非使用 --ignore-submodules 命令行选项将其覆盖。git submodule 命令不受此设置影响。默认设置为 untracked，因此任何未跟踪的子模块都会被忽略。

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

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

如果设置了，git diff 使用指定的源前缀。否则，默认为 a/。

如果设置了，git diff 使用指定的目标前缀。否则，默认是 b。

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

该文件定义了在 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 diff Porcelain 命令，而不影响如 git-diff-files[1] 这样的底层命令。

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

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

POSIX 扩展正则表达式，用于在进行逐字差异计算时确定什么是 "字"。符合正则表达式的字符序列为 "字"，所有其他字符均为 不可忽略的 空白。

自定义的 diff 驱动命令。详见 gitattributes[5]。

如果这个布尔值设置为 true，那么 diff.<驱动程序>.command 命令被期望在认为输入文件相等时返回退出码 0，在认为它们不同时返回退出码 1，类似于 diff(1)。如果它被设置为 false，这是默认值，那么期望该命令无论文件是否相等都返回退出码 0。任何其他的退出码都会导致 Git 报告一个致命错误。

正则表达式，diff 驱动程序应使用该正则表达式识别块状头。也可以使用内置模式。详见 gitattributes[5]。

将此选项设为 true，可使 diff 驱动程序将文件视为二进制文件。详情参见 gitattributes[5]。

diff 驱动程序为生成文件的文本转换版本而调用的命令。转换结果用于生成易读形式的 diff 结果。详见 gitattributes[5]。

正则表达式，diff 驱动程序应使用它来分割一行中的单词。详见 gitattributes[5]。

将此选项设为 true 可使 diff 驱动程序缓存文本转换输出。详见 gitattributes[5]。

将此选项设为 false，可禁用默认的启发式方法，该方法会移动差异块边界，使补丁更容易读取。

选择差异算法。有如下可选项：

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

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

当使用 diff.colorMoved 等设置为移动的行着色时，此选项控制空格的处理模式。有效模式的详情请参见 git-diff[1] 中的 --color-moved-ws。

该选项控制 git fetch（以及 git pull 底层执行的 fetch）是否会递归获取已填充的子模块。它可以设置为布尔值或 on-demand。设为布尔值时，true 表示 fetch 和 pull 会无条件递归进入子模块，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 基对象之后，会将收到的 pack 作为 pack 存储。将 push 收到的 pack 直接存储为 pack 可使 push 更快完成，尤其是在较慢的文件系统上。如果未设置，则改用 transfer.unpackLimit 的值。

如果为 true，fetch 会自动表现得如同命令行提供了 --prune 选项。另见 remote.<name>.prune 和 git-fetch[1] 的 PRUNING 章节。

如果为 true，且尚未设置相关 refspec，则 fetch 在 prune 时会自动表现得如同提供了 refs/tags/*:refs/tags/* 这个 refspec。这样可以同时设置该选项和 fetch.prune，以保持与上游 ref 的 1:1 映射。另见 remote.<name>.pruneTags 和 git-fetch[1] 的 PRUNING 章节。

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

控制 ref 更新状态的打印方式。有效值为 full 和 compact。默认值为 full。详情参见 git-fetch[1] 的 OUTPUT 章节。

控制在协商服务器要发送的 packfile 内容时，如何发送本地仓库中提交的信息。设为 consecutive 时，使用遍历连续提交并逐个检查的算法。设为 skipping 时，使用跳过部分提交以更快收敛的算法，但可能产生比必要更大的 packfile；设为 noop 则完全不发送任何信息，这几乎肯定会导致 packfile 大于必要大小，但会跳过协商步骤。设为 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 从远程下载 pack-file 后都写入 commit-graph。使用 --split 选项时，大多数执行只会在现有 commit-graph 文件之上创建一个很小的 commit-graph 文件。偶尔这些文件会合并，写入时间可能更长。保持 commit-graph 文件为最新有助于提升许多 Git 命令的性能，包括 git merge-base、git push -f 和 git log --graph。默认值为 false。

该值保存一个 URI，用于在从 origin Git 服务器执行增量 fetch 之前，通过 bundle URI 下载 Git 对象数据。这与 git-clone[1] 中 --bundle-uri 选项的行为类似。如果提供的 bundle URI 包含为增量 fetch 组织的 bundle 列表，则 git clone --bundle-uri 会设置 fetch.bundleURI 的值。

当使用 fetch.bundleURI 从采用 "creationToken" 启发式的 bundle 列表进行增量获取时，该配置值会保存已下载 bundle 的最大 creationToken 值。如果后续通告的 creationToken 不严格大于该值，则会利用此值阻止再次下载这些 bundle。

指定将要复制模板的目录。(See the "TEMPLATE DIRECTORY" section of git-init[1].)

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

允许覆写新仓库的对象格式。参见 git-init[1] 中的 --object-format=。并且，命令行选项和环境变量 GIT_DEFAULT_HASH 都优先于该配置。

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

一个布尔值，指定 git init 和 git clone 是否应自动将 extensions.submodulePathConfig 设置为 true。这允许所有新仓库自动使用子模块路径扩展。未设置时默认为 false。

如果为 true，则让 git-log[1]、git-show[1] 和 git-whatchanged[1] 默认采用 --abbrev-commit。你可以使用 --no-abbrev-commit 覆盖此选项。

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

打印 log 命令显示的各个提交的 ref 名称。可取值包括：

默认情况下，git log 只会显示某些已知 ref 命名空间的修饰信息。如果指定为 all，则将所有 ref 都显示为修饰信息。

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

设置在指定 --diff-merges=on 时使用的 diff 格式。详见 git-log[1] 中的 --diff-merges。默认值为 separate。

如果为 true，则当给出单个 <路径> 时，git log 的行为就如同使用了 --follow 选项。这与 --follow 有相同的限制，即它不能用于跟踪多个文件，且在非线性历史上效果不佳。

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

如果为 true，则会将初始提交显示为一个重大的创建事件。这等价于与空树进行 diff。像 git-log[1] 或 git-whatchanged[1] 这样通常会隐藏根提交的工具，此时也会显示它。默认值为 true。

如果为真，则使 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 选项。默认为真。

指定合并时将冲突块写入工作区树文件的样式。 默认样式是 "merge"（合并），它会显示一个 <<<<<<< 冲突标记、一方所做的更改、一个 ======= 标记、另一方所做的更改，然后是一个 >>>>>>> 标记。 另一种样式 "diff3" 会在 "=======" 标记前添加 "|||||||" 标记和原文。 “合并” 样式产生的冲突区域往往比 diff3 小，一是因为不包含原始文本，二是因为当双方有子集行匹配时，这些行会被从冲突区域中拉出。 另一种样式是 "zdiff3"，它与 diff3 类似，但会在冲突区域的开头或结尾附近出现匹配行时，将这些匹配行从冲突区域中移除。

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

默认情况下，当合并当前提交的后裔提交时，Git 不会创建一个额外的合并提交。相反，当前分支的顶端会被快进。当设置为 "false "时，这个变量告诉Git在这种情况下创建一个额外的合并提交（相当于在命令行中给出 --no-ff 选项）。当设置为 only 时，只允许这种快进合并（相当于从命令行给出 --ff-only 选项）。

如果为真，这等同于 --verify-signatures 命令行选项。详见 git-merge[1]。

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

除了分支名称外，在日志信息中最多加入指定数量的被合并的实际提交的单行描述。 默认为 false，true 是2 0 的同义词。

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

合并过程中重命名检测穷举部分要考虑的文件数量。 如果未指定，默认值为 diff.renameLimit 的值。 如果既未指定 merge.renameLimit 也未指定 diff.renameLimit，则默认值为 7000。 如果重命名检测已关闭，则此设置无效。

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

Git 是否检测目录重命名。这会影响这样一种情况在合并时的处理方式：历史的一侧向某个目录新增了文件，而该目录在历史的另一侧被重命名。可取值包括：

告诉 Git，仓库中文件的规范表示形式会随时间变化（例如，较早的提交记录的文本文件使用 CRLF 行尾，而较新的提交使用 LF 行尾）。在这样的仓库中，对于每个需要执行三方内容合并的文件，Git 都可以在执行合并前将提交中记录的数据转换为规范形式，以减少不必要的冲突。更多信息请参阅 gitattributes[5] 中的“合并具有不同签入/检出属性的分支”一节。

指定在合并结束时，在 ORIG_HEAD 与合并结果之间打印什么内容（如果要打印的话）。可取值包括：

当设置为 "true "时，在操作开始前自动创建一个临时的贮藏库条目，并在操作结束后应用它。 这意味着你可以在一个肮脏的工作区上运行merge。 然而，要小心使用：在成功的合并之后，最后的贮藏库应用可能会导致非实质性的冲突。 这个选项可以被 git-merge[1] 的 --no-autostash 和 --autostash 选项覆盖。 默认为 false。

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

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

控制递归合并策略所显示的输出量。 0级除了在检测到冲突时有一个最终的错误信息外，什么都不输出。1级只输出冲突，2级输出冲突和文件变化。 5级及以上输出调试信息。 默认是第2级。 可以通过 GIT_MERGE_VERBOSITY 环境变量覆盖。

为自定义的低级合并驱动定义了一个具有可读性的名字。 详情见 gitattributes[5]。

定义实现自定义低级合并驱动程序的命令。详见链接 gitattributes[5]。

在执行共同祖先之间的内部合并时，命名一个低级别的合并驱动。 详情见 gitattributes[5]。

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

指定调用该 merge 工具的命令。该命令会在 shell 中求值，并可使用下列变量：BASE 是一个临时文件名，包含待合并文件的共同基础（如果有）；LOCAL 是一个临时文件名，包含当前分支上该文件的内容；REMOTE 是一个临时文件名，包含正在合并的分支中该文件的内容；MERGED 包含 merge 工具应写入成功合并结果的文件名。

允许用户为特定工具覆盖全局 mergetool.hideResolved 的值。完整说明见 mergetool.hideResolved。

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

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

给出 --auto-merge 时，meld 会自动合并所有无冲突部分，高亮冲突部分，并等待用户决策。将 mergetool.meld.useAutoMerge` 设为 true 会告诉 Git 无条件对 meld 使用 --auto-merge 选项。将其设为 auto 会让 git 检测是否支持 --auto-merge，并仅在可用时使用该选项。值为 false 则完全避免使用 --auto-merge，这也是默认值。

Configure the split window layout for vimdiff’s <variant>, which is any of vimdiff, nvimdiff, gvimdiff. Upon launching git mergetool with --tool=<variant> (or without --tool if merge.tool is configured as <variant>), Git will consult mergetool.<variant>.layout to determine the tool’s layout. If the variant-specific configuration is not available, vimdiff ' s is used as fallback. If that too is not available, a default layout with 4 windows will be used. To configure the layout, see the BACKEND SPECIFIC HINTS section in git-mergetool[1].

在合并期间，Git 会自动尽可能多地解决冲突，并写出 $MERGED 文件，在其无法解决的冲突周围保留冲突标记；$LOCAL 和 $REMOTE 通常是 Git 进行冲突解决之前的文件版本。该标志会覆盖 $LOCAL 和 $REMOTE，使 merge 工具只看到未解决的冲突。可通过 mergetool.<tool>.hideResolved 配置变量按工具分别配置。默认值为 false。

执行 merge 后，带冲突标记的原始文件可保存为一个带 .orig 扩展名的文件。如果该变量设为 false，则不保留该文件。默认值为 true（即保留备份文件）。

调用自定义 merge 工具时，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 设置的默认值外，在使用 git log 系列命令显示提交信息时，还应从哪个 ref（如果使用 glob 或指定多次，则为哪些 ref）中读取注释。

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

在重写过程中复制注释时（参见 notes.rewrite.<command> 选项），用于决定如果目标提交已经有注释时该怎么做。其值必须为 overwrite、concatenate、cat_sort_uniq 或 ignore 之一。默认值为 concatenate。

在重写过程中复制注释时，指定应复制其注释的（完全限定）ref。也可以是 glob，此时会复制所有匹配 ref 中的注释。你也可以多次指定该配置。

若设为 true，当当前分支尚无上游跟踪分支时，默认 push 会假定带上 --set-upstream；该选项在 push.default 为 simple、upstream 和 current 时生效。若你希望新分支默认推送到默认远程（类似 push.default=current 的行为），同时又希望设置上游跟踪关系，则此选项很有用。最可能受益的工作流是 simple 的集中式工作流：期望所有分支在远程都有同名分支。

定义在未提供 refspec（无论来自命令行、配置或其他来源）时 git push 应采取的动作。不同取值适合不同工作流；例如在纯集中式工作流（即 fetch 源与 push 目的地相同）中，upstream 可能是你想要的。可能取值包括：

若设为 true，则默认启用 --follow-tags。你可以在推送时指定 --no-follow-tags 覆盖此配置。

可设为布尔值或字符串 if-asked。值为 true 时，所有推送都会进行 GPG 签名，效果等同于向 git-push[1] 传入 --signed。值为 if-asked 时，若服务器支持则对推送进行签名，效果等同于向 git push 传入 --signed=if-asked。值为 false 可覆盖来自更低优先级配置文件的设置。命令行显式标志总会覆盖此配置选项。

当命令行未给出任何 --push-option=<option> 参数时，git push 的行为就像为本变量中的每个 <option> 都提供了 --push-option=<option> 一样。

例如：

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

~/.gitconfig
  push.pushoption = c

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

这将导致只剩下 b（a 和 c 被清除）。

可以是 check、on-demand、only 或 no，其行为与 push --recurse-submodules 相同。若未设置，则默认使用 no，除非设置了 submodule.recurse（此时值为 true 表示 on-demand）。

若设为 true，等同于在命令行中为 git-push[1] 指定 --force-if-includes 选项。在 push 时添加 --no-force-if-includes 会覆盖此配置。

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

若设为 false，则即使 pack.useBitmaps 为 true，也会禁用 git push 对 bitmap 的使用，但不会 阻止其他 git 操作使用 bitmap。默认值为 true。

rebase 默认使用的后端。可选值为 apply 或 merge。将来如果 merge 后端获得 apply 后端剩余的全部能力，该设置可能会变得无用。

显示上次变基后上游变化的差异状态。差异状态也由配置选项 rebase.stat 控制。

如果设为 true，则在交互模式下默认启用 git-rebase[1] 的 --autosquash 选项。可用 --no-autosquash 覆盖。

当设为 true 时，会在操作开始前自动创建一个临时 stash 条目，并在操作结束后重新应用它。这意味着你可以在脏工作区上运行 rebase。不过请谨慎使用：成功 rebase 之后最后一次应用 stash 可能会导致并不简单的冲突。该选项可由 git-rebase[1] 的 --no-autostash 和 --autostash 选项覆盖。默认值为 false。

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

如果设为 "warn"，当某些提交被移除时（例如删除了一行），git rebase -i 会打印警告，但 rebase 仍会继续。如果设为 "error"，则会打印前述警告并停止 rebase，此时可使用 git rebase --edit-todo 来纠正错误。如果设为 "ignore"，则不做检查。若要在不产生警告或错误的情况下丢弃某个提交，请在 todo 列表中使用 drop 命令。默认值为 "ignore"。

一个按 git-log[1] 所规定的格式字符串，用于交互式 rebase 期间的 todo 列表。该格式会自动在前面附加提交哈希。

如果设为 true，git rebase 会在 todo 列表中使用缩写命令名，结果类似于：

p deadbee 本次提交的一行说明
p fa1afe1 下一次提交的一行说明
...

pick deadbee 本次提交的一行说明
pick fa1afe1 下一次提交的一行说明
...

自动重新安排执行失败的 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 的长度（以便例如为相应的松散 ref 写入 .lock 文件）。

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

如果设为 true，git stash apply 和 git stash pop 的行为将如同提供了 --index。默认值为 false。 参见 git-stash[1] 中的说明。

如果设为 true，则 git stash show 命令会显示 stash 条目中的未跟踪文件。默认值为 false。See the description of the 'show' command in git-stash[1].

如果设为 true，则不带选项的 git stash show 命令会以 patch 形式显示 stash 条目。默认值为 false。See the description of the 'show' command in git-stash[1].

如果设为 true，则不带选项的 git stash show 命令会显示 stash 条目的 diffstat。默认值为 true。See the description of the 'show' command in git-stash[1].

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

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

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

如果未指定分支，且也未使用 -b、-B 或 --detach，那么 git worktree add 默认会从 HEAD 创建一个新分支。如果 worktree.guessRemote 设为 true，worktree add 会尝试查找一个名称与新分支名唯一匹配的远程跟踪分支。如果找到这样的分支，就会检出该分支，并将其设置为新分支的“上游”分支。如果找不到这样的匹配项，则退回到从当前 HEAD 创建新分支。

使用相对路径（值为 "true" 时）或绝对路径（值为 "false" 时）来链接工作区。这对于仓库和工作区可能会在不同位置或环境之间移动的部署场景尤其有用。默认值为 "false"。