简体中文 ▾ 主题 ▾ 最新版本 ▾ git-config 最后更新于 2.50.0

名称

git-config - 获取和设置仓库或全局选项

概要

git config list [<file-option>] [<display-option>] [--includes]
git config get [<file-option>] [<display-option>] [--includes] [--all] [--regexp] [--value=<value>] [--fixed-value] [--default=<default>] <name>
git config set [<file-option>] [--type=<type>] [--all] [--value=<value>] [--fixed-value] <name> <value>
git config unset [<file-option>] [--all] [--value=<value>] [--fixed-value] <name>
git config rename-section [<file-option>] <old-name> <new-name>
git config remove-section [<file-option>] <name>
git config edit [<file-option>]
git config [<file-option>] --get-colorbool <name> [<stdout-is-tty>]

描述

您可以使用此命令查询/设置/替换/取消设置选项。名称实际上是使用点分隔的节和键,值将被转义。

通过使用 --append 选项,可以向一个选项添加多行。如果要更新或取消设置一个可以出现多行的选项,则需要提供一个 value-pattern(这是一个扩展正则表达式,除非给定 --fixed-value 选项)。只有与模式匹配的现有值才会被更新或取消设置。如果要处理匹配模式的行,只需在其前面加上一个感叹号(另请参见 示例),但请注意,这仅在未使用 --fixed-value 选项时才有效。

选项 --type=<type> 指示 git config 确保传入和传出的值在给定 <type> 下可规范化。如果未给定 --type=<type>,则不会执行规范化。调用者可以使用 --no-type 取消设置现有的 --type 指定符。

读取时,默认情况下从系统、全局和仓库本地配置文件中读取值,并且可以使用 --system--global--local--worktree--file <filename> 选项来告诉命令仅从该位置读取(参见 文件)。

写入时,新值默认写入仓库本地配置文件,并且可以使用 --system--global--worktree--file <filename> 选项来告诉命令写入该位置(您可以使用 --local 但这是默认值)。

此命令在出错时将以非零状态失败。一些退出代码是:

  • 节或键无效 (ret=1),

  • 未提供节或名称 (ret=2),

  • 配置文件无效 (ret=3),

  • 配置文件无法写入 (ret=4),

  • 您尝试取消设置不存在的选项 (ret=5),

  • 您尝试取消设置/设置多行匹配的选项 (ret=5), 或

  • 您尝试使用无效的正则表达式 (ret=6)。

成功时,命令返回退出代码 0。

可以使用 git help --config 命令获取所有可用配置变量的列表。

命令

list

列出配置文件中设置的所有变量及其值。

get

输出指定键的值。如果配置中键多次出现,则输出最后一个值。如果指定了 --all,则输出与键关联的所有值。如果键不存在,则返回错误代码 1。

set

为一个或多个配置选项设置值。默认情况下,此命令拒绝写入多值配置选项。传递 --all 将用新值替换所有多值配置选项,而 --value= 将替换所有值与给定模式匹配的配置选项。

unset

为一个或多个配置选项取消设置值。默认情况下,此命令拒绝取消设置多值键。传递 --all 将取消设置所有多值配置选项,而 --value 将取消设置所有值与给定模式匹配的配置选项。

rename-section

将给定节重命名为新名称。

remove-section

从配置文件中删除给定节。

edit

打开编辑器以修改指定的配置文件;可以是 --system--global--local(默认)、--worktree--file <config-file>

选项

--replace-all

默认行为是最多替换一行。此选项将替换所有匹配键(并可选匹配 value-pattern)的行。

--append

在选项中添加新行,而不更改任何现有值。这与在 set 中提供 --value=^$ 相同。

--comment <message>

在新的或修改的行末尾附加注释。

If _<message>_ begins with one or more whitespaces followed
by "#", it is used as-is.  If it begins with "#", a space is
prepended before it is used.  Otherwise, a string " # " (a
space followed by a hash followed by a space) is prepended
to it.  And the resulting string is placed immediately after
the value defined for the variable.  The _<message>_ must
not contain linefeed characters (no multi-line comments are
permitted).
--all

对于 get,返回多值键的所有值。

--regexp

对于 get,将名称解释为正则表达式。正则表达式匹配目前区分大小写,并对键的规范化版本进行,其中节和变量名转换为小写,但子节名不转换。

--url=<URL>

当给定两部分的 <name> 作为 <section>.<key> 时,返回 <section>.<URL>.<key> 的值,其中 <URL> 部分与给定 URL 最匹配(如果不存在此类键,则使用 <section>.<key> 的值作为备用)。当仅给定 <section> 作为名称时,对该节中的所有键执行此操作并列出它们。如果未找到值,则返回错误代码 1。

--global

对于写入选项:写入全局 ~/.gitconfig 文件而不是仓库 .git/config,如果 $XDG_CONFIG_HOME/git/config 文件存在且 ~/.gitconfig 文件不存在,则写入 $XDG_CONFIG_HOME/git/config 文件。

对于读取选项:只从全局 ~/.gitconfig$XDG_CONFIG_HOME/git/config 读取,而不是从所有可用文件读取。

另请参见 文件

--system

对于写入选项:写入系统范围的 $(prefix)/etc/gitconfig 而不是仓库 .git/config

对于读取选项:只从系统范围的 $(prefix)/etc/gitconfig 读取,而不是从所有可用文件读取。

另请参见 文件

--local

对于写入选项:写入仓库 .git/config 文件。这是默认行为。

对于读取选项:只从仓库 .git/config 读取,而不是从所有可用文件读取。

另请参见 文件

--worktree

--local 类似,但如果启用了 extensions.worktreeConfig,则从 $GIT_DIR/config.worktree 读取或写入。如果未启用,则与 --local 相同。请注意,对于主工作树,$GIT_DIR 等于 $GIT_COMMON_DIR,但对于其他工作树,其形式为 $GIT_DIR/worktrees/<id>/。请参阅 git-worktree[1] 了解如何启用 extensions.worktreeConfig

-f <config-file>
--file <config-file>

对于写入选项:写入指定文件而不是仓库 .git/config

对于读取选项:只从指定文件读取,而不是从所有可用文件读取。

另请参见 文件

--blob <blob>

--file 类似,但使用给定 blob 而不是文件。例如,您可以使用 master:.gitmodules 从 master 分支中的 .gitmodules 文件读取值。有关拼写 blob 名称的更完整方式列表,请参阅 gitrevisions[7] 中的“SPECIFYING REVISIONS”节。

--fixed-value

value-pattern 参数一起使用时,将 value-pattern 视为精确字符串而不是正则表达式。这将限制匹配的名称/值对仅限于值与 value-pattern 完全相等的那些。

--type <type>

git config 将确保任何输入或输出在给定类型约束下有效,并将输出值规范化为 <type> 的规范形式。

有效的 <type> 包括:

  • bool: 将值 trueyeson 和正数规范化为“true”,将值 falsenooff0 规范化为“false”。

  • int: 将值规范化为简单的十进制数字。可选的后缀 kmg 将导致输入值乘以 1024、1048576 或 1073741824。

  • bool-or-int: 按照上述 boolint 规范化。

  • path: 通过将开头的 ~ 展开为 $HOME 的值,将 ~user 展开为指定用户的主目录来规范化。此指定符在设置值时无效(但您可以使用命令行中的 git config section.variable ~/ 让您的 shell 执行展开)。

  • expiry-date: 通过将固定或相对日期字符串转换为时间戳来规范化。此指定符在设置值时无效。

  • color: 获取值时,通过转换为 ANSI 颜色转义序列来规范化。设置值时,会执行健全性检查以确保给定值可规范化为 ANSI 颜色,但会按原样写入。

--bool
--int
--bool-or-int
--path
--expiry-date

用于选择类型指定符的旧选项。推荐改为使用 --type(见上文)。

--no-type

取消设置之前设置的类型指定符(如果之前已设置)。此选项请求 git config 不规范化检索到的变量。--no-type 在没有 --type=<type>--<type> 的情况下无效。

-z
--null

对于所有输出值和/或键的选项,始终以空字符(而不是换行符)结束值。使用换行符作为键和值之间的分隔符。这允许安全地解析输出,而不会因包含换行符的值等而混淆。

--name-only

对于 listget,只输出配置变量的名称。

--show-origin

使用来源类型(文件、标准输入、blob、命令行)和实际来源(配置文件路径、ref 或 blob id,如果适用)来扩充所有查询到的配置选项的输出。

--show-scope

类似于 --show-origin,它使用该值的范围(工作树、本地、全局、系统、命令)来扩充所有查询到的配置选项的输出。

--get-colorbool <name> [<stdout-is-tty>]

查找 <name>(例如 color.diff)的颜色设置,并输出“true”或“false”。<stdout-is-tty> 应该是“true”或“false”,并在配置设置为“auto”时被考虑在内。如果 <stdout-is-tty> 缺失,则检查命令自身的标准输出,如果应使用颜色则以状态 0 退出,否则以状态 1 退出。当 name 的颜色设置未定义时,命令将使用 color.ui 作为备用。

--[no-]includes

查找值时,遵守配置文件中的 include.* 指令。当给定特定文件(例如,使用 --file--global 等)时,默认为 off;搜索所有配置文件时,默认为 on

--default <value>

使用 get 时,如果未找到请求的变量,则表现为 <value> 已分配给该变量。

已废弃模式

以下模式已被子命令取代。建议迁移到新语法。

git config <name>

已被 git config get <name> 取代。

git config <name> <value> [<value-pattern>]

已被 git config set [--value=<pattern>] <name> <value> 取代。

-l
--list

已被 git config list 取代。

--get <name> [<value-pattern>]

已被 git config get [--value=<pattern>] <name> 取代。

--get-all <name> [<value-pattern>]

已被 git config get [--value=<pattern>] --all <name> 取代。

--get-regexp <name-regexp>

已被 git config get --all --show-names --regexp <name-regexp> 取代。

--get-urlmatch <name> <URL>

已被 git config get --all --show-names --url=<URL> <name> 取代。

--get-color <name> [<default>]

已被 git config get --type=color [--default=<default>] <name> 取代。

--add <name> <value>

已被 git config set --append <name> <value> 取代。

--unset <name> [<value-pattern>]

已被 git config unset [--value=<pattern>] <name> 取代。

--unset-all <name> [<value-pattern>]

已被 git config unset [--value=<pattern>] --all <name> 取代。

--rename-section <old-name> <new-name>

已被 git config rename-section <old-name> <new-name> 取代。

--remove-section <name>

已被 git config remove-section <name> 取代。

-e
--edit

已被 git config edit 取代。

配置

pager.config 仅在列出配置时生效,即在使用 list 或可能返回多个结果的 get 时。默认是使用分页器。

文件

默认情况下,git config 将从多个文件读取配置选项:

$(prefix)/etc/gitconfig

系统范围的配置文件。

$XDG_CONFIG_HOME/git/config
~/.gitconfig

用户特定的配置文件。当 XDG_CONFIG_HOME 环境变量未设置或为空时,使用 $HOME/.config/ 作为 $XDG_CONFIG_HOME。

这些文件也称为“全局”配置文件。如果这两个文件都存在,则按上述顺序读取这两个文件。

$GIT_DIR/config

仓库特定的配置文件。

$GIT_DIR/config.worktree

这是可选的,仅当 $GIT_DIR/config 中存在 extensions.worktreeConfig 时才会被搜索。

您还可以在运行任何 git 命令时使用 -c 选项提供额外的配置参数。有关详细信息,请参阅 git[1]

选项将从所有这些可用文件中读取。如果全局或系统范围的配置文件缺失或不可读,它们将被忽略。如果仓库配置文件缺失或不可读,git config 将以非零错误代码退出。如果文件不可读,则会产生错误消息,但如果文件缺失则不会。

文件按上述顺序读取,后找到的值优先于先前读取的值。当取多个值时,将使用所有文件中键的所有值。

默认情况下,选项仅写入仓库特定的配置文件。请注意,这也影响 setunset 等选项。git config 一次只会更改一个文件

您可以通过使用 --file 选项指定文件路径,或通过使用 --system--global--local--worktree 指定配置范围来限制从哪些配置源读取或写入。更多信息,请参见上面的 选项

范围

每个配置源都属于一个配置范围。范围包括:

system

$(prefix)/etc/gitconfig

global

$XDG_CONFIG_HOME/git/config

~/.gitconfig

local

$GIT_DIR/config

worktree

$GIT_DIR/config.worktree

command

GIT_CONFIG_{COUNT,KEY,VALUE} 环境变量(参见下面的 环境

-c 选项

除了 command 之外,每个范围都对应一个命令行选项:--system--global--local--worktree

读取选项时,指定范围将只从该范围内的文件读取选项。写入选项时,指定范围将写入该范围内的文件(而不是仓库特定的配置文件)。有关完整描述,请参见上面的 选项

大多数配置选项无论其定义在哪个范围都受尊重,但有些选项仅在特定范围受尊重。有关详细信息,请参阅相应选项的文档。

受保护的配置

受保护的配置指的是 systemglobalcommand 范围。出于安全原因,某些选项只有在受保护的配置中指定时才受尊重,否则将被忽略。

Git 将这些范围视为由用户或受信任的管理员控制。这是因为控制这些范围的攻击者可以在不使用 Git 的情况下造成实质性损害,因此假定用户的环境可以保护这些范围免受攻击者侵害。

环境

GIT_CONFIG_GLOBAL
GIT_CONFIG_SYSTEM

从给定文件而不是全局或系统级别配置中获取配置。有关详细信息,请参阅 git[1]

GIT_CONFIG_NOSYSTEM

是否跳过从系统范围的 $(prefix)/etc/gitconfig 文件读取设置。有关详细信息,请参阅 git[1]

另请参见 文件

GIT_CONFIG_COUNT
GIT_CONFIG_KEY_<n>
GIT_CONFIG_VALUE_<n>

如果 GIT_CONFIG_COUNT 设置为正数,则所有 GIT_CONFIG_KEY_<n> 和 GIT_CONFIG_VALUE_<n> 环境变量对(最多达到该数字)将被添加到进程的运行时配置中。配置对是零索引的。任何缺失的键或值都被视为错误。空的 GIT_CONFIG_COUNT 被视为与 GIT_CONFIG_COUNT=0 相同,即不处理任何对。这些环境变量将覆盖配置文件的值,但将被通过 git -c 传递的任何显式选项覆盖。

这对于您希望使用共同配置生成多个 git 命令但不能依赖配置文件的情况很有用,例如在编写脚本时。

GIT_CONFIG

如果未向 git config 提供 --file 选项,则使用 GIT_CONFIG 给定的文件,如同通过 --file 提供一样。此变量对其他 Git 命令没有影响,主要用于历史兼容性;通常没有理由使用它而不是 --file 选项。

示例

给定一个 .git/config 文件,如下所示:

#
# This is the config file, and
# a '#' or ';' character indicates
# a comment
#

; core variables
[core]
	; Don't trust file modes
	filemode = false

; Our diff algorithm
[diff]
	external = /usr/local/bin/diff-wrapper
	renames = true

; Proxy settings
[core]
	gitproxy=proxy-command for kernel.org
	gitproxy=default-proxy ; for all the rest

; HTTP
[http]
	sslVerify
[http "https://weak.example.com"]
	sslVerify = false
	cookieFile = /tmp/cookie.txt

您可以使用以下命令将 filemode 设置为 true:

% git config set core.filemode true

假设的代理命令条目实际上有一个后缀来区分它们适用于哪个 URL。以下是如何将 kernel.org 的条目更改为“ssh”。

% git config set --value='for kernel.org$' core.gitproxy '"ssh" for kernel.org'

这确保只替换 kernel.org 的键/值对。

要删除 renames 的条目,请执行:

% git config unset diff.renames

如果要删除多值变量(如上面的 core.gitproxy)的条目,必须提供一个与恰好一行值匹配的正则表达式。

要查询给定键的值,请执行:

% git config get core.filemode

或者,要查询多值变量:

% git config get --value="for kernel.org$" core.gitproxy

如果您想知道多值变量的所有值,请执行:

% git config get --all --show-names core.gitproxy

如果您喜欢冒险,可以使用以下命令将所有 core.gitproxy 替换为新的:

% git config set --all core.gitproxy ssh

但是,如果您真的只想替换默认代理的行,即没有“for ...”后缀的行,请执行以下操作:

% git config set --value='! for ' core.gitproxy ssh

要实际只匹配带有感叹号的值,您需要:

% git config set --value='[!]' section.key value

要添加新的代理,而不更改任何现有代理,请使用:

% git config set --append core.gitproxy '"proxy-command" for example.com'

一个在脚本中使用自定义颜色的示例:

#!/bin/sh
WS=$(git config get --type=color --default="blue reverse" color.diff.whitespace)
RESET=$(git config get --type=color --default="reset" "")
echo "${WS}your whitespace color or blue reverse${RESET}"

对于 https://weak.example.com 中的 URL,http.sslVerify 设置为 false,而对于所有其他 URL,则设置为 true

% git config get --type=bool --url=https://good.example.com http.sslverify
true
% git config get --type=bool --url=https://weak.example.com http.sslverify
false
% git config get --url=https://weak.example.com http
http.cookieFile /tmp/cookie.txt
http.sslverify false

配置文件

Git 配置文件包含许多影响 Git 命令行为的变量。每个仓库中的文件 .git/config 以及可选的 config.worktree(参见 git-worktree[1] 的“CONFIGURATION FILE”节)用于存储该仓库的配置,而 $HOME/.gitconfig 用于存储每用户配置作为 .git/config 文件的备用值。文件 /etc/gitconfig 可用于存储系统范围的默认配置。

配置变量由 Git 管道命令和瓷器命令共同使用。变量分为多个节,其中变量的完全限定名称本身是最后一个点分隔的段,节名称是最后一个点之前的所有内容。变量名不区分大小写,只允许使用字母数字字符和 -,并且必须以字母字符开头。某些变量可能多次出现;我们称该变量为多值变量。

语法

语法相当灵活和宽松。空白字符,在此上下文中指空格字符 (SP) 和水平制表符 (HT),大部分被忽略。字符 #; 开始注释到行尾。空行被忽略。

文件由节和变量组成。节以方括号中的节名称开始,并持续到下一个节开始。节名称不区分大小写。节名称中只允许使用字母数字字符、-.。每个变量必须属于某个节,这意味着在变量的第一个设置之前必须有一个节标题。

节可以进一步细分为子节。要开始一个子节,请在节标题中将其名称用双引号括起来,并用空格与节名称分隔,如下例所示:

	[section "subsection"]

子节名称区分大小写,可以包含除换行符和空字节之外的任何字符。双引号 " 和反斜杠可以通过分别转义为 \"\\ 来包含。反斜杠后面的其他字符在读取时会被丢弃;例如,\t 读取为 t\0 读取为 0。节标题不能跨多行。变量可以直接属于某个节或属于给定子节。如果存在 [section "subsection"],则可以有 [section],但并非必需。

还有一种已废弃的 [section.subsection] 语法。使用此语法时,子节名称将转换为小写,并且也区分大小写进行比较。这些子节名称遵循与节名称相同的限制。

所有其他行(以及节标题后的行剩余部分)都被识别为设置变量,形式为 name = value(或仅 name,这是变量为布尔值“true”的简写)。变量名不区分大小写,只允许字母数字字符和 -,并且必须以字母字符开头。

围绕着 name=value 的空白字符会被丢弃。value 内部的空白字符会原样保留。以 #; 开头并延伸到行尾的注释会被丢弃。定义值的行可以通过以反斜杠 (\) 结尾来延续到下一行;反斜杠和行尾字符都会被丢弃。

如果 value 需要包含前导或尾随的空白字符,则必须用双引号 (") 括起来。在双引号内,双引号 (") 和反斜杠 (\) 字符必须进行转义:使用 \" 表示 ",使用 \\ 表示 \

识别以下转义序列(除了 \"\\):\n 表示换行符 (NL),\t 表示水平制表符 (HT, TAB),\b 表示退格符 (BS)。其他字符转义序列(包括八进制转义序列)是无效的。

包含

通过 includeincludeIf 部分,您可以从另一个源包含配置指令。这些部分的表现方式相同,唯一的例外是,如果 includeIf 部分的条件评估结果不为 true,则可能会被忽略;请参阅下面的“条件包含”。

您可以通过将特殊变量 include.path(或 includeIf.*.path)设置为要包含的文件名,从而从另一个文件包含配置。该变量以路径名作为其值,并受波浪号扩展的影响。这些变量可以多次给出。

被包含文件的内容会立即插入,就像它们在包含指令的位置被找到一样。如果变量的值是相对路径,则该路径被视为相对于找到包含指令的配置文件。请参见下面的示例。

条件包含

您可以通过将 includeIf.<condition>.path 变量设置为要包含的文件名,从而有条件地从另一个文件包含配置文件。

条件以一个关键字开头,后跟一个冒号和一些数据,这些数据的格式和含义取决于关键字。支持的关键字有:

gitdir

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

.git 位置可以是自动发现的,也可以来自 $GIT_DIR 环境变量。如果仓库是通过 .git 文件自动发现的(例如,来自子模块或链接工作树),则 .git 位置将是 .git 目录的最终位置,而不是 .git 文件的位置。

该模式可以包含标准的 globbing 通配符和另外两个通配符 **//**,它们可以匹配多个路径组件。详情请参阅 gitignore[5]。为方便起见

  • 如果模式以 ~/ 开头,则 ~ 将被替换为环境变量 HOME 的内容。

  • 如果模式以 ./ 开头,则它会被替换为包含当前配置文件的目录。

  • 如果模式不是以 ~/.// 开头,则会自动前置 **/。例如,模式 foo/bar 会变成 **/foo/bar,并会匹配 /any/path/to/foo/bar

  • 如果模式以 / 结尾,则会自动添加 **。例如,模式 foo/ 会变成 foo/**。换句话说,它会递归地匹配“foo”及其内部的所有内容。

gitdir/i

这与 gitdir 相同,只是匹配时不区分大小写(例如,在不区分大小写的文件系统上)。

onbranch

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

如果模式以 / 结尾,则会自动添加 **。例如,模式 foo/ 会变成 foo/**。换句话说,它会匹配所有以 foo/ 开头的分支。如果您的分支是分层组织的,并且您想将配置应用于该层次结构中的所有分支,这将非常有用。

hasconfig:remote.*.url:

此关键字后面的数据被视为一个模式,包含标准的 globbing 通配符和另外两个 **//**,它们可以匹配多个组件。首次看到此关键字时,将扫描其余配置文件以查找远程 URL(不应用任何值)。如果至少存在一个与此模式匹配的远程 URL,则满足包含条件。

通过此选项(直接或间接)包含的文件不允许包含远程 URL。

请注意,与其他 includeIf 条件不同,解析此条件依赖于在读取条件时尚未知晓的信息。典型的用例是此选项作为系统级或全局级配置存在,而远程 URL 在本地级配置中;因此在解析此条件时需要提前扫描。为了避免潜在包含的文件可能影响这些文件是否被潜在包含的“鸡生蛋,蛋生鸡”问题,Git 通过禁止这些文件影响这些条件的解析(从而禁止它们声明远程 URL)来打破循环。

至于此关键字的命名,是为了向前兼容支持更多基于变量的包含条件的命名方案,但目前 Git 仅支持上面描述的精确关键字。

关于通过 gitdirgitdir/i 进行匹配的几点说明

  • $GIT_DIR 中的符号链接在匹配前不会被解析。

  • 路径的符号链接和真实路径版本都将在 $GIT_DIR 之外进行匹配。例如,如果 ~/git 是 /mnt/storage/git 的符号链接,那么 gitdir:~/gitgitdir:/mnt/storage/git 都将匹配。

    这在 v2.13.0 的此功能初始版本中并非如此,该版本只匹配真实路径版本。希望与此功能的初始版本兼容的配置需要仅指定真实路径版本,或同时指定两个版本。

  • 请注意,"../" 并非特殊字符,它会进行字面匹配,这可能不是您想要的。

示例

# Core variables
[core]
	; Don't trust file modes
	filemode = false

# Our diff algorithm
[diff]
	external = /usr/local/bin/diff-wrapper
	renames = true

[branch "devel"]
	remote = origin
	merge = refs/heads/devel

# Proxy settings
[core]
	gitProxy="ssh" for "kernel.org"
	gitProxy=default-proxy ; for the rest

[include]
	path = /path/to/foo.inc ; include by absolute path
	path = foo.inc ; find "foo.inc" relative to the current file
	path = ~/foo.inc ; find "foo.inc" in your `$HOME` directory

; include if $GIT_DIR is /path/to/foo/.git
[includeIf "gitdir:/path/to/foo/.git"]
	path = /path/to/foo.inc

; include for all repositories inside /path/to/group
[includeIf "gitdir:/path/to/group/"]
	path = /path/to/foo.inc

; include for all repositories inside $HOME/to/group
[includeIf "gitdir:~/to/group/"]
	path = /path/to/foo.inc

; relative paths are always relative to the including
; file (if the condition is true); their location is not
; affected by the condition
[includeIf "gitdir:/path/to/group/"]
	path = foo.inc

; include only if we are in a worktree where foo-branch is
; currently checked out
[includeIf "onbranch:foo-branch"]
	path = foo.inc

; include only if a remote with the given URL exists (note
; that such a URL may be provided later in a file or in a
; file read after this file is read, as seen in this example)
[includeIf "hasconfig:remote.*.url:https://example.com/**"]
	path = foo.inc
[remote "origin"]
	url = https://example.com/git

许多变量的值被视为简单的字符串,但也有一些变量接受特定类型的值,并且有关于如何拼写它们的规则。

布尔值

当一个变量被指定接受布尔值时,truefalse 有许多同义词被接受;它们都不区分大小写。

true

布尔真值字面量有 yesontrue1。此外,未定义 = <value> 的变量也被视为真。

false

布尔假值字面量有 noofffalse0 和空字符串。

当使用 --type=bool 类型说明符将值转换为其规范形式时,git config 将确保输出为“true”或“false”(小写拼写)。

整数

许多指定各种大小的变量值可以后缀 kM 等,表示“按 1024 缩放”、“按 1024x1024 缩放”等。

颜色

接受颜色值的变量,其值是一个颜色列表(最多两个,一个用于前景,一个用于背景)和属性(任意数量),它们之间用空格分隔。

接受的基本颜色有 normalblackredgreenyellowbluemagentacyanwhitedefault。给出的第一个颜色是前景色;第二个是背景色。除了 normaldefault 之外的所有基本颜色都有一个亮色变体,可以通过在颜色前加上 bright 来指定,例如 brightred

颜色 normal 不会改变颜色。它与空字符串相同,但当单独指定背景色时(例如,“normal red”)可用作前景色。

颜色 default 明确地将颜色重置为终端默认值,例如指定一个清除的背景。尽管它因终端而异,但这通常与设置为“white black”不同。

颜色也可以给出 0 到 255 之间的数字;这些使用 ANSI 256 色模式(但请注意,并非所有终端都可能支持此模式)。如果您的终端支持,您还可以将 24 位 RGB 值指定为十六进制,例如 #ff0ab3,或 12 位 RGB 值,例如 #f1b,这等同于 24 位颜色 #ff11bb

接受的属性有 bold(粗体)、dim(暗淡)、ul(下划线)、blink(闪烁)、reverse(反转)、italic(斜体)和 strike(删除线)。任何属性相对于颜色的位置(之前、之后或中间)无关紧要。特定属性可以通过前置 nono- 来关闭(例如,noreverseno-ul 等)。

伪属性 reset 在应用指定着色之前重置所有颜色和属性。例如,reset green 将产生一个绿色前景和默认背景,且没有任何活动属性。

一个空的颜色字符串完全不产生任何颜色效果。这可以用于避免对特定元素着色,而无需完全禁用颜色。

对于 Git 的预定义颜色槽,属性应在彩色输出中每个项目的开头重置。因此,将 color.decorate.branch 设置为 black 会将该分支名称涂成纯粹的 black,即使同一输出行上的前一个内容(例如,log --decorate 输出中分支名称列表之前的左括号)被设置为用 bold 或其他属性着色。然而,自定义日志格式可能会进行更复杂和分层的着色,并且否定形式在那里可能很有用。

路径名

接受路径名值的变量可以给定一个以 "~/" 或 "~user/" 开头的字符串,并且对这种字符串会发生通常的波浪号扩展:~/ 会扩展为 $HOME 的值,而 ~user/ 会扩展为指定用户的家目录。

如果路径以 %(prefix)/ 开头,则其余部分被解释为相对于 Git 的“运行时前缀”的路径,即相对于 Git 本身安装位置的路径。例如,%(prefix)/bin/ 指的是 Git 可执行文件本身所在的目录。如果 Git 在没有运行时前缀支持的情况下编译,则会替换为编译时内置的前缀。万一需要指定不应扩展的字面路径,则需要以 ./ 为前缀,例如:./%(prefix)/bin

变量

请注意,此列表并非详尽无遗,也不一定完整。对于特定于命令的变量,您将在相应的手册页中找到更详细的描述。

其他与 Git 相关的工具可能会并且确实使用它们自己的变量。当为您自己的工具发明新变量时,请确保它们的名称不与 Git 本身和其他常用工具使用的名称冲突,并在您的文档中描述它们。

add.ignoreErrors
add.ignore-errors(已弃用)

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

advice.*

这些变量控制旨在帮助新用户的各种可选帮助消息。当未配置时,Git 会给出消息以及如何抑制它的说明。您可以通过将相应变量设置为 false 来告知 Git 您已理解问题并且不再需要特定帮助消息。

由于这些消息旨在帮助人类用户,它们会输出到标准错误。当将 Git 作为子进程运行的工具发现它们具有干扰性时,可以在环境中设置 GIT_ADVICE=0 来抑制所有建议消息。

addEmbeddedRepo

当用户意外地将一个 Git 仓库添加到另一个仓库内部时显示。

addEmptyPathspec

当用户运行 git add 而未提供 pathspec 参数时显示。

addIgnoredFile

当用户尝试将一个被忽略的文件添加到索引时显示。

amWorkDir

git-am[1] 无法应用补丁文件时显示,以告知用户文件位置。

ambiguousFetchRefspec

当多个远程仓库的 fetch refspec 映射到同一个远程跟踪分支命名空间并导致分支跟踪设置失败时显示。

checkoutAmbiguousRemoteBranchName

git-checkout[1]git-switch[1] 的参数在多个远程仓库中模糊地解析为远程跟踪分支,而明确的参数原本会导致检出远程跟踪分支时显示。有关如何在打印此建议的某些情况下设置默认使用的给定远程仓库,请参阅 checkout.defaultRemote 配置变量。

commitBeforeMerge

git-merge[1] 拒绝合并以避免覆盖本地更改时显示。

detachedHead

当用户使用 git-switch[1]git-checkout[1] 切换到分离 HEAD 状态时显示,以告知用户事后如何创建本地分支。

diverging

当无法进行快进合并时显示。

fetchShowForcedUpdates

git-fetch[1] 在引用更新后花费很长时间计算强制更新,或警告该检查已禁用时显示。

forceDeleteBranch

当用户尝试在未设置 force 选项的情况下删除未完全合并的分支时显示。

ignoredHook

当一个 hook 被忽略,因为该 hook 未设置为可执行文件时显示。

implicitIdentity

当用户的身份信息从系统用户名和域名猜测得出时显示,以告知用户如何设置其身份配置。

mergeConflict

当各种命令因冲突而停止时显示。

nestedTag

当用户尝试递归标记一个标签对象时显示。

pushAlreadyExists

git-push[1] 拒绝不符合快进更新条件的更新时显示(例如,标签)。

pushFetchFirst

git-push[1] 拒绝尝试覆盖指向本地不存在对象的远程引用时显示。

pushNeedsForce

git-push[1] 拒绝尝试覆盖指向非 commit-ish 对象的远程引用,或者使远程引用指向非 commit-ish 对象时显示。

pushNonFFCurrent

git-push[1] 因当前分支的非快进更新而失败时显示。

pushNonFFMatching

当用户运行 git-push[1] 并显式推送“匹配引用”(即使用了 :,或指定了一个不是当前分支的 refspec),并且导致了非快进错误时显示。

pushRefNeedsUpdate

git-push[1] 拒绝强制更新一个分支,而该分支的远程跟踪引用有本地不存在的更新时显示。

pushUnqualifiedRefname

git-push[1] 放弃根据源和目标引用猜测源所属的远程引用命名空间,但我们仍然可以根据源对象的类型建议用户推送到 refs/heads/*refs/tags/* 时显示。

pushUpdateRejected

如果您想同时禁用 pushNonFFCurrentpushNonFFMatchingpushAlreadyExistspushFetchFirstpushNeedsForcepushRefNeedsUpdate,请将此变量设置为 false

rebaseTodoError

编辑 rebase 待办列表后出现错误时显示。

refSyntax

当用户提供了非法的引用名称时显示,以告知用户引用语法文档。

resetNoRefresh

git-reset[1] 在重置后刷新索引花费超过 2 秒时显示,以告知用户可以使用 --no-refresh 选项。

resolveConflict

当冲突阻止操作执行时,由各种命令显示。

rmHints

git-rm[1] 的输出中失败时显示,以给出如何从当前状态继续操作的指示。

sequencerInUse

当一个序列器命令已在进行中时显示。

skippedCherryPicks

git-rebase[1] 跳过一个已 cherry-pick 到上游分支的提交时显示。

sparseIndexExpanded

当稀疏索引扩展为完整索引时显示,这很可能是由于稀疏检出之外存在一组意外的文件。

statusAheadBehind

git-status[1] 计算本地引用与其远程跟踪引用相比的超前/滞后计数,并且该计算花费的时间超出预期时显示。如果 status.aheadBehind 为 false 或给出了 --no-ahead-behind 选项,则不会出现。

statusHints

git-status[1] 的输出中,在 git-commit[1] 中编写提交消息时显示的模板中,以及在 git-switch[1]git-checkout[1] 切换分支时显示的帮助消息中,显示如何从当前状态继续操作的指示。

statusUoption

git-status[1] 枚举未跟踪文件花费超过 2 秒时显示,以告知用户可以使用 -u 选项。

submoduleAlternateErrorStrategyDie

当配置为“die”的 submodule.alternateErrorStrategy 选项导致致命错误时显示。

submoduleMergeConflict

遇到非平凡的子模块合并冲突时显示的建议。

submodulesNotUpdated

当用户运行子模块命令失败,因为未运行 git submodule update --init 时显示。

suggestDetachingHead

git-switch[1] 拒绝在没有显式 --detach 选项的情况下分离 HEAD 时显示。

updateSparsePath

git-add[1]git-rm[1] 被要求更新当前稀疏检出之外的索引条目时显示。

waitingForEditor

当 Git 等待编辑器输入时显示。例如,当编辑器未在终端内部启动时,这会很有用。

worktreeAddOrphan

当用户尝试从无效引用创建工作树时显示,以告知用户如何改为创建新的未初始化分支。

alias.*

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

请注意,别名的第一个词不一定是命令。它可以是一个命令行选项,该选项将被传递给 git 的调用。特别是在与 -c 一起使用以传递一次性配置或与 -p 一起使用以强制分页时,这非常有用。例如,可以定义 loud-rebase = -c commit.verbose=true rebase,使得运行 git loud-rebase 等同于 git -c commit.verbose=true rebase。此外,ps = -p status 也将是一个有用的别名,因为 git ps 会对 git status 的输出进行分页,而原始命令不会。

如果别名展开以感叹号为前缀,则它将被视为 shell 命令。例如,定义 alias.new = !gitk --all --not ORIG_HEAD,则调用 git new 等同于运行 shell 命令 gitk --all --not ORIG_HEAD。注意

  • Shell 命令将从仓库的顶层目录执行,这不一定是当前目录。

  • GIT_PREFIX 设置为从原始当前目录运行 git rev-parse --show-prefix 所返回的值。请参阅 git-rev-parse[1]

  • Shell 命令别名始终将提供给 Git 命令行的任何额外参数作为位置参数接收。

    • 如果您的 shell 别名是一个包含多个命令(例如在管道中)的“单行”脚本,引用多个参数,或者无法处理在末尾添加的位置参数,则应小心。例如:将 alias.cmd = "!echo $1 | grep $2" 作为 git cmd 1 2 调用时,将执行为 echo $1 | grep $2 1 2,这不是您想要的结果。

    • 处理这个问题的一个便捷方法是将您的脚本操作写入一个内联函数,然后通过命令行提供的任何参数调用该函数。例如 `alias.cmd = "!c() { echo $1 | grep $2 ; }; c" 将正确执行前一个示例。

    • 设置 GIT_TRACE=1 可以帮助您调试别名运行的命令。

am.keepcr

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

am.threeWay

默认情况下,如果补丁不能干净地应用,git am 将失败。当设置为 true 时,此设置会告诉 git am 在补丁记录了它应该应用到的 blob 的标识并且我们在本地有这些 blob 可用时,回退到三向合并(等同于从命令行给出 --3way 选项)。默认为 false。请参阅 git-am[1]

apply.ignoreWhitespace

当设置为 change 时,指示 git apply 忽略空白字符的更改,与 --ignore-space-change 选项相同。当设置为:no、none、never、false 之一时,指示 git apply 尊重所有空白字符差异。请参阅 git-apply[1]

apply.whitespace

指示 git apply 如何处理空白字符,与 --whitespace 选项相同。请参阅 git-apply[1]

attr.tree

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

注意
bitmapPseudoMerge.* 中的配置选项被认为是实验性的,将来可能会更改或完全删除。有关伪合并位图功能的更多信息,请参阅 gitpacking[7] 的“伪合并位图”部分。
bitmapPseudoMerge.<name>.pattern

用于匹配引用名称的正则表达式。由匹配此模式的引用指向的提交(并满足以下条件,例如 bitmapPseudoMerge.<name>.sampleRatebitmapPseudoMerge.<name>.threshold)将被考虑包含在伪合并位图中。

提交根据指向给定提交的任何引用是否匹配模式(这是一个扩展正则表达式)而被分组到伪合并组中。

在伪合并组内,提交可以根据模式中的捕获组进一步分组到子组中。这些子分组是通过将正则表达式中的任何捕获组用一个 - 短划线连接起来形成的。

例如,如果模式是 refs/tags/,那么所有标签(如果它们满足以下条件)都将被视为同一伪合并组的候选。然而,如果模式改为 refs/remotes/([0-9])+/tags/,那么来自不同远程仓库的标签将根据远程编号分组到不同的伪合并组中。

bitmapPseudoMerge.<name>.decay

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

将衰减率设置为 0 会使所有组的大小相同。将衰减率设置为 1 会使第 n 个组的大小为初始组的 1/n。衰减率的更高值会导致连续组以更快的速度缩小。默认值为 1

如果所有组的大小相同,那么包含较新提交的组可能比早期组使用得更少,因为指向较新提交的引用比指向旧提交的引用更有可能被更频繁地更新。

bitmapPseudoMerge.<name>.sampleRate

确定选入不稳定伪合并位图中非位图化提交(在引用尖端中)的比例。必须在 01 之间(包括两端)。默认值为 1

bitmapPseudoMerge.<name>.threshold

确定非位图化提交(在引用尖端中,如上所述)的最小年龄,这些提交是可用于不稳定伪合并位图的候选。默认值为 1.week.ago

bitmapPseudoMerge.<name>.maxMerges

确定提交可以分布到的最大伪合并提交数量。

对于其模式不包含任何捕获组的伪合并组,此设置适用于所有匹配正则表达式的提交。对于具有一个或多个捕获组的模式,此设置适用于每个不同的捕获组。

例如,如果你的捕获组是 refs/tags/,则此设置会将所有标签分布到最多 maxMerges 个伪合并提交中。但是,如果你的捕获组是,例如 refs/remotes/([0-9]+)/tags/,则此设置将分别应用于每个远程的标签集。

必须是非负数。默认值为 64。

bitmapPseudoMerge.<name>.stableThreshold

确定提交(在引用尖端中,如上所述,但稳定提交即使已被位图覆盖仍被视为候选)的最小年龄,这些提交是用于稳定伪合并位图的候选。默认值为 1.month.ago

将此阈值设置为较小的值(例如,1.week.ago)将导致生成更多稳定组(这会产生一次性生成成本),但这些组可能会随着时间推移变得过时。使用较大的值会产生相反的缺点(稳定组较少但更有用)。

bitmapPseudoMerge.<name>.stableSize

确定稳定伪合并位图的大小(以提交数量计)。默认值为 512

blame.blankBoundary

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

blame.coloring

这决定了应用于 blame 输出的着色方案。它可以是 repeatedLineshighlightRecentnone(默认值)。

blame.date

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

blame.showEmail

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

blame.showRoot

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

blame.ignoreRevsFile

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

blame.markUnblamableLines

git-blame[1] 的输出中,用 * 标记被忽略修订更改但无法归因于其他提交的行。

blame.markIgnoredLines

git-blame[1] 的输出中,用 ? 标记被忽略修订更改但归因于其他提交的行。

branch.autoSetupMerge

告诉 git branchgit switchgit checkout 设置新分支,以便 git-pull[1] 能够适当地从起始分支合并。请注意,即使未设置此选项,也可以使用 --track--no-track 选项按分支选择此行为。此选项默认为 true。有效设置包括:

false

不进行自动设置

true

当起始点是远程跟踪分支时,自动进行设置

always

当起始点是本地分支或远程跟踪分支时,自动进行设置

inherit

如果起始点有跟踪配置,则将其复制到新分支

simple

仅当起始点是远程跟踪分支且新分支与远程分支同名时,才进行自动设置。

branch.autoSetupRebase

当使用 git branchgit switchgit checkout 创建跟踪另一个分支的新分支时,此变量会告诉 Git 将拉取操作设置为 rebase 而不是 merge(请参阅 branch.<name>.rebase)。有效设置包括:

never

rebase 永远不会自动设置为 true。

local

对于其他本地分支的跟踪分支,rebase 设置为 true。

remote

对于远程跟踪分支的跟踪分支,rebase 设置为 true。

always

对于所有跟踪分支,rebase 将设置为 true。

有关如何设置分支以跟踪另一个分支的详细信息,请参阅 branch.autoSetupMerge。此选项默认为 never

branch.sort

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

branch.<name>.remote

当位于分支 <name> 上时,它告诉 git fetchgit push 从哪个远程仓库抓取或推送到哪个远程仓库。要推送到的远程仓库可以通过 remote.pushDefault(适用于所有分支)来覆盖。对于当前分支,要推送到的远程仓库可以进一步通过 branch.<name>.pushRemote 来覆盖。如果未配置远程仓库,或者你不在任何分支上并且仓库中定义了多个远程仓库,则抓取时默认为 origin,推送时默认为 remote.pushDefault。此外,.(一个点)是当前本地仓库(一个点仓库),请参阅下面 branch.<name>.merge 的最后一条注释。

branch.<name>.pushRemote

当位于分支 <name> 上时,它会覆盖用于推送的 branch.<name>.remote。它还会覆盖从分支 <name> 推送时的 remote.pushDefault。当你从一个地方(例如你的上游)拉取并推送到另一个地方(例如你自己的发布仓库)时,你可能希望设置 remote.pushDefault 来指定所有分支的推送远程仓库,并使用此选项来覆盖特定分支的设置。

branch.<name>.merge

branch.<name>.remote 一起定义给定分支的上游分支。它告诉 git fetch/git pull/git rebase 要合并哪个分支,并且还可以影响 git push(请参阅 push.default)。当位于分支 <name> 中时,它告诉 git fetch 要在 FETCH_HEAD 中标记合并的默认 refspec。该值被视为 refspec 的远程部分,并且必须与从 branch.<name>.remote 给定的远程仓库抓取的引用匹配。合并信息由 git pull(它首先调用 git fetch)用于查找默认合并分支。如果没有此选项,git pull 默认为合并抓取的第一个 refspec。指定多个值以进行章鱼合并。如果你希望设置 git pull 以便它从本地仓库的另一个分支合并到 <name>,你可以将 branch.<name>.merge 指向所需分支,并使用相对路径设置 .(一个点)作为 branch.<name>.remote

branch.<name>.mergeOptions

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

branch.<name>.rebase

当为 true 时,在运行 git pull 时,将分支 <name> rebase 到抓取的分支之上,而不是从默认远程仓库合并默认分支。有关以非分支特定方式执行此操作,请参阅 pull.rebase

当为 merges(或简写为 m)时,将 --rebase-merges 选项传递给 git rebase,以便将本地合并提交包含在 rebase 中(详情请参阅 git-rebase[1])。

当值为 interactive(或简写为 i)时,rebase 以交互模式运行。

注意:这是一个可能有危险的操作;除非你理解其影响(详情请参阅 git-rebase[1]),否则不要使用它。

branch.<name>.description

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

browser.<tool>.cmd

指定调用指定浏览器的命令。指定的命令将在 shell 中评估,URL 作为参数传递。(请参阅 git-web--browse[1]。)

browser.<tool>.path

覆盖给定工具的路径,该工具可用于浏览 HTML 帮助(请参阅 git-help[1] 中的 -w 选项)或 gitweb 中的工作仓库(请参阅 git-instaweb[1])。

bundle.*

bundle.* 键可能出现在通过 git clone --bundle-uri 选项找到的捆绑列表文件中。如果这些键放在仓库配置文件中,目前无效,但将来会改变。有关详细信息,请参阅 捆绑 URI 设计文档

bundle.version

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

bundle.mode

此字符串值应为 allany。此值描述是否需要所有通告的捆绑包才能完全解捆绑捆绑的信息(all),或者是否列出的任何一个捆绑 URI 就足够了(any)。

bundle.heuristic

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

bundle.<id>.*

bundle.<id>.* 键用于描述捆绑列表中的单个项目,按 <id> 分组以进行识别。

bundle.<id>.uri

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

checkout.defaultRemote

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

目前,当 git checkout <something>git switch <something> 将检出另一个远程仓库上的 <something> 分支时,此设置由 git-switch[1]git-checkout[1] 使用;当 git worktree add 引用远程分支时,此设置由 git-worktree[1] 使用。将来,此设置可能会用于其他类似 checkout 的命令或功能。

checkout.guess

提供 git checkoutgit switch--guess--no-guess 选项的默认值。请参阅 git-switch[1]git-checkout[1]

checkout.workers

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

注意
并行检出通常为位于 SSD 或通过 NFS 的仓库提供更好的性能。对于位于旋转磁盘和/或核心数量较少的机器上的仓库,默认的顺序检出通常表现更好。仓库的大小和压缩级别也可能影响并行版本的性能。
checkout.thresholdForParallelism

当并行检出少量文件时,子进程生成和进程间通信的开销可能大于并行化带来的收益。此设置允许你定义应尝试并行检出的最小文件数。默认值为 100。

clean.requireForce

一个布尔值,用于使 git-clean 拒绝删除文件,除非给定 -f 选项。默认为 true。

clone.defaultRemoteName

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

clone.rejectShallow

如果仓库是浅克隆,则拒绝克隆;这可以通过在命令行上传递 --reject-shallow 选项来覆盖。请参阅 git-clone[1]

clone.filterSubmodules

如果提供了部分克隆过滤器(请参阅 --filtergit-rev-list[1] 中)并且使用了 --recurse-submodules,则也对子模块应用该过滤器。

color.advice

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

color.advice.hint

为提示使用自定义颜色。

color.blame.highlightRecent

根据行的创建时间,指定 git blame --color-by-age 的行注释颜色。

此设置应为一个逗号分隔的颜色和日期设置列表,以颜色开头和结尾,日期应从最旧到最新设置。如果该行在给定时间戳之前引入,元数据将用指定颜色着色,覆盖旧的时间戳颜色。

除了绝对时间戳,相对时间戳也有效,例如 2.weeks.ago 对于任何早于 2 周的内容都有效。

它默认为 blue,12 month ago,white,1 month ago,red,这将一年前的旧内容着色为蓝色,一个月到一年内的近期更改保持白色,而最近一个月内引入的行则着色为红色。

color.blame.repeatedLines

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

color.branch

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

color.branch.<slot>

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

color.diff

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

这不影响 git-format-patch[1]git-diff-* 底层命令。可以在命令行上使用 --color[=<when>] 选项覆盖。

color.diff.<slot>

为差异着色使用自定义颜色。<slot> 指定补丁的哪一部分使用指定颜色,它是以下之一:context(上下文文本 - plain 是历史同义词)、meta(元信息)、frag( hunk 头部)、func( hunk 头部中的函数)、old(已删除行)、new(已添加行)、commit(提交头部)、whitespace(高亮显示空白错误)、oldMoved(已删除行)、newMoved(已添加行)、oldMovedDimmedoldMovedAlternativeoldMovedAlternativeDimmednewMovedDimmednewMovedAlternative newMovedAlternativeDimmed(有关详细信息,请参阅 git-diff[1]--color-moved<mode> 设置)、contextDimmedoldDimmednewDimmedcontextBoldoldBoldnewBold(有关详细信息,请参阅 git-range-diff[1])。

color.decorate.<slot>

git log --decorate 输出使用自定义颜色。<slot> 分别是用于本地分支、远程跟踪分支、标签、stash 和 HEAD 的 branchremoteBranchtagstashHEAD 之一,以及用于嫁接提交的 grafted

color.grep

当设置为 always 时,始终高亮显示匹配项。当设置为 false(或 never)时,从不。当设置为 trueauto 时,仅当输出写入终端时才使用颜色。如果未设置,则使用 color.ui 的值(默认为 auto)。

color.grep.<slot>

为 grep 着色使用自定义颜色。<slot> 指定行的哪一部分使用指定颜色,它是以下之一:

context

上下文行中不匹配的文本(当使用 -A-B-C 时)

filename

文件名前缀(当不使用 -h 时)

function

函数名行(当使用 -p 时)

lineNumber

行号前缀(当使用 -n 时)

column

列号前缀(当使用 --column 时)

match

匹配文本(与设置 matchContextmatchSelected 相同)

matchContext

上下文行中的匹配文本

matchSelected

选定行中的匹配文本。此外,还用于自定义以下 git-log[1] 子命令:--grep--author--committer

selected

选定行中不匹配的文本。此外,还用于自定义以下 git-log[1] 子命令:--grep--author--committer

separator

行中字段之间的分隔符(:-=)以及块之间的分隔符(--

color.interactive

当设置为 always 时,交互式提示和显示(例如 "git-add --interactive" 和 "git-clean --interactive" 使用的那些)始终使用颜色。当为 false(或 never)时,从不使用。当设置为 trueauto 时,仅当输出到终端时才使用颜色。如果未设置,则使用 color.ui 的值(默认为 auto)。

color.interactive.<slot>

git add --interactivegit clean --interactive 的输出使用自定义颜色。<slot> 可以是 promptheaderhelperror,用于交互式命令的四种不同类型的正常输出。

color.pager

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

color.push

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

color.push.error

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

color.remote

如果设置,行开头的关键字将被高亮显示。关键字是 "error"、"warning"、"hint" 和 "success",不区分大小写匹配。可以设置为 alwaysfalse(或 never)或 auto(或 true)。如果未设置,则使用 color.ui 的值(默认为 auto)。

color.remote.<slot>

为每个远程关键字使用自定义颜色。<slot> 可以是 hintwarningsuccesserror,它们与相应的关键字匹配。

color.showBranch

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

color.status

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

color.status.<slot>

使用自定义颜色进行状态着色。<slot> 是以下之一:header(状态消息的标题文本)、addedupdated(已添加但未提交的文件)、changed(已更改但未添加到索引的文件)、untracked(Git 未跟踪的文件)、branch(当前分支)、nobranch(显示无分支警告的颜色,默认为红色)、localBranchremoteBranch(在状态短格式中显示分支和跟踪信息时,分别为本地和远程分支名称),或 unmerged(有未合并更改的文件)。

color.transport

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

color.transport.rejected

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

color.ui

此变量确定 color.diffcolor.grep 等控制每个命令族颜色使用的变量的默认值。随着更多命令学习配置以设置 --color 选项的默认值,其范围将扩大。如果您希望 Git 命令不使用颜色,除非通过其他配置或 --color 选项明确启用,请将其设置为 falsenever。如果您希望所有不用于机器消费的输出都使用颜色,请将其设置为 always;如果您希望此类输出在写入终端时使用颜色,请将其设置为 trueauto(这是 Git 1.8.4 以来的默认值)。

column.ui

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

这些选项控制何时启用此功能(默认为 never

always

始终以列形式显示

never

从不以列形式显示

auto

如果输出到终端,则以列形式显示

这些选项控制布局(默认为 column)。如果未指定 alwaysneverauto 中的任何一个,则设置其中任何一个都意味着 always

column

先填充列再填充行

row

先填充行再填充列

plain

以一列显示

最后,这些选项可以与布局选项结合使用(默认为 nodense

dense

创建不等大小的列以利用更多空间

nodense

创建等大小的列

column.branch

指定是否以列形式输出 git branch 中的分支列表。详情请参阅 column.ui

column.clean

指定在 git clean -i 中列出项目时的布局,该命令始终以列形式显示文件和目录。详情请参阅 column.ui

column.status

指定是否以列形式输出 git status 中的未跟踪文件。详情请参阅 column.ui

column.tag

指定是否以列形式输出 git tag 中的标签列表。详情请参阅 column.ui

commit.cleanup

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

commit.gpgSign

一个布尔值,用于指定是否所有提交都应进行 GPG 签名。在执行 rebase 等操作时使用此选项可能导致大量提交被签名。使用代理可能很方便,以避免多次键入您的 GPG 密码短语。

commit.status

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

commit.template

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

commit.verbose

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

commitGraph.generationVersion

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

commitGraph.maxNewFilters

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

commitGraph.readChangedPaths

已弃用。如果为 true,则等同于 commitGraph.changedPathsVersion=-1;如果为 false,则等同于 commitGraph.changedPathsVersion=0。(如果 commitGraph.changedPathVersion 也已设置,则 commitGraph.changedPathsVersion 优先。)

commitGraph.changedPathsVersion

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

默认为 -1。

如果为 -1,Git 将使用仓库中已更改路径布隆过滤器的版本,如果不存在,则默认为 1。

如果为 0,Git 将不读取任何布隆过滤器,并在指示写入时写入版本 1 布隆过滤器。

如果为 1,Git 将只读取版本 1 布隆过滤器,并写入版本 1 布隆过滤器。

如果为 2,Git 将只读取版本 2 布隆过滤器,并写入版本 2 布隆过滤器。

更多信息请参阅 git-commit-graph[1]

completion.commands

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

core.fileMode

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

某些文件系统在检出标记为可执行的文件时会丢失可执行位,或者在检出非可执行文件时将其可执行位置为开启。git-clone[1]git-init[1] 会探测文件系统以查看它是否正确处理可执行位,并根据需要自动设置此变量。

然而,仓库可能位于正确处理文件模式的文件系统上,并且在创建时此变量被设置为 true,但之后可能会从另一个丢失文件模式的环境(例如通过 CIFS 挂载导出 ext4,使用 Git for Windows 或 Eclipse 访问 Cygwin 创建的仓库)访问。在这种情况下,可能需要将此变量设置为 false。请参阅 git-update-index[1]

默认值为 true(当 core.filemode 未在配置文件中指定时)。

core.hideDotFiles

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

core.ignoreCase

内部变量,用于启用各种变通方法,使 Git 在不区分大小写的文件系统(如 APFS、HFS+、FAT、NTFS 等)上更好地工作。例如,如果目录列表找到 "makefile" 而 Git 期望 "Makefile",Git 将假定它实际上是同一个文件,并继续将其记住为 "Makefile"。

默认值为 false,但 git-clone[1]git-init[1] 会在创建仓库时探测并在适当时将 core.ignoreCase 设置为 true。

Git 依赖于此变量针对您的操作系统和文件系统的正确配置。修改此值可能会导致意外行为。

core.precomposeUnicode

此选项仅由 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 向后兼容。

core.protectHFS

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

core.protectNTFS

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

core.fsmonitor

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

与基于钩子的文件系统监视器一样,内置文件系统监视器可以加速在包含许多文件的工作目录中需要刷新 Git 索引(例如 git status)的 Git 命令。内置监视器消除了安装和维护外部第三方工具的需要。

内置文件系统监视器目前仅在有限的支持平台上可用。目前,这包括 Windows 和 MacOS。

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

此钩子命令用于识别自请求日期/时间以来可能已更改的所有文件。此信息通过避免不必要地扫描未更改的文件来加速 Git。

请参阅 githooks[5] 的 "fsmonitor-watchman" 部分。

请注意,如果您同时使用多个版本的 Git,例如命令行上的一个版本和 IDE 工具中的另一个版本,那么 core.fsmonitor 的定义已扩展,除了钩子路径名之外还允许布尔值。Git 2.35.1 及更早版本将不理解布尔值,并将 "true" 或 "false" 值视为要调用的钩子路径名。Git 2.26 到 2.35.1 版本默认为钩子协议 V2,并将回退到不使用 fsmonitor(完全扫描)。Git 2.26 之前的版本默认为钩子协议 V1,并将静默地假定没有要报告的更改(不扫描),因此状态命令可能会报告不完整的结果。因此,在使用内置文件系统监视器之前,最好升级所有 Git 版本。

core.fsmonitorHookVersion

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

目前有版本 1 和 2。如果未设置此项,则将首先尝试版本 2,如果失败,则尝试版本 1。版本 1 使用时间戳作为输入来确定自该时间以来哪些文件发生了更改,但像 Watchman 这样的一些监视器在使用时间戳时存在竞态条件。版本 2 使用不透明字符串,以便监视器可以返回可用于确定哪些文件已更改而无竞态条件的内容。

core.trustctime

如果为 false,则忽略索引和工作树之间的 ctime 差异;当 inode 更改时间经常被 Git 外部的某些东西(文件系统爬虫和一些备份系统)修改时,这很有用。请参阅 git-update-index[1]。默认为 true。

core.splitIndex

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

core.untrackedCache

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

core.checkStat

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

有些 Git 实现不会在某些字段中留下可用值(例如 JGit);通过将这些字段从比较中排除,minimal 模式可能有助于当这些其他系统同时使用同一个仓库时的互操作性。

core.quotePath

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

core.eol

设置工作目录中标记为文本(通过设置 text 属性,或通过 text=auto 和 Git 自动检测内容为文本)的文件的行尾类型。可选值包括 lfcrlfnative,其中 native 使用平台的原生行尾。默认值为 native。有关行尾转换的更多信息,请参阅 gitattributes[5]。请注意,如果 core.autocrlf 设置为 trueinput,则此值将被忽略。

core.safecrlf

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

CRLF 转换有轻微损坏数据的风险。启用时,Git 会在提交时将 CRLF 转换为 LF,在检出时将 LF 转换为 CRLF。提交前包含 LF 和 CRLF 混合的文件无法由 Git 重新创建。对于文本文件,这是正确的做法:它纠正行尾,使仓库中只有 LF 行尾。但对于意外分类为文本的二进制文件,转换可能会损坏数据。

如果您及早发现此类损坏,可以通过在 .gitattributes 中明确设置转换类型轻松修复。提交后,您的工作树中仍有原始文件,且此文件尚未损坏。您可以明确告诉 Git 此文件是二进制文件,Git 将会妥善处理该文件。

不幸的是,清理混合行尾的文本文件所期望的效果与损坏二进制文件所不期望的效果无法区分。在这两种情况下,CRLF 都以不可逆的方式被移除。对于文本文件,这是正确的做法,因为 CRLF 是行尾,而对于二进制文件,转换 CRLF 会损坏数据。

请注意,此安全检查并不意味着在 core.eolcore.autocrlf 设置不同的情况下,检出将生成与原始文件相同的文件,而仅适用于当前设置。例如,一个带有 LF 的文本文件,在 core.eol=lf 的情况下会被接受,之后可以使用 core.eol=crlf 检出,在这种情况下,生成的文件将包含 CRLF,尽管原始文件包含 LF。然而,在两个工作树中,行尾将是一致的,即要么全部是 LF,要么全部是 CRLF,但绝不会混合。带有混合行尾的文件将由 core.safecrlf 机制报告。

core.autocrlf

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

core.checkRoundtripEncoding

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

如果为 false,符号链接将作为包含链接文本的小型普通文件检出。git-update-index[1]git-add[1] 不会将记录的类型更改为常规文件。这在不支持符号链接的文件系统(如 FAT)上很有用。

默认值为 true,但 git-clone[1]git-init[1] 会在创建仓库时探测并在适当时将 core.symlinks 设置为 false。

core.gitProxy

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

可以通过 GIT_PROXY_COMMAND 环境变量覆盖(该变量始终普遍适用,没有特殊的“for”处理)。

特殊字符串 none 可以用作代理命令,以指定不对给定域模式使用代理。这对于将防火墙内的服务器排除在代理使用之外,同时对外部域默认使用通用代理很有用。

core.sshCommand

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

core.ignoreStat

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

当文件在 Git 之外被修改时,用户需要显式地暂存这些修改过的文件(例如,参见 git-update-index[1] 中的示例部分)。Git 通常不会检测到这些文件的更改。

这在 lstat() 调用非常慢的系统(如 CIFS/Microsoft Windows)上很有用。

默认为 False。

core.preferSymlinkRefs

对于 HEAD 和其他符号引用文件,不使用默认的 "symref" 格式,而是使用符号链接。有时需要这样做才能与那些期望 HEAD 是符号链接的旧脚本一起工作。

core.alternateRefsCommand

从备用源宣传可用历史记录的提示时,使用 shell 执行指定的命令,而不是 git-for-each-ref[1]。第一个参数是备用源的绝对路径。输出必须每行包含一个十六进制对象 ID(即,与 git for-each-ref --format='%(objectname) 产生的结果相同)。

请注意,通常不能将 git for-each-ref 直接放入配置值中,因为它不接受仓库路径作为参数(但可以将上述命令封装在 shell 脚本中)。

core.alternateRefsPrefixes

从备用源列出引用时,只列出以给定前缀开头的引用。前缀的匹配方式与将它们作为参数传递给 git-for-each-ref[1] 时的匹配方式相同。要列出多个前缀,请使用空格分隔它们。如果设置了 core.alternateRefsCommand,则设置 core.alternateRefsPrefixes 无效。

core.bare

如果为 true,则该仓库被认为是裸仓库,并且没有关联的工作目录。在这种情况下,许多需要工作目录的命令将被禁用,例如 git-add[1]git-merge[1]

当仓库被创建时,git-clone[1]git-init[1] 会自动推断此设置。默认情况下,以 "/.git" 结尾的仓库被认为不是裸仓库 (bare = false),而所有其他仓库则被认为是裸仓库 (bare = true)。

core.worktree

设置工作树根目录的路径。如果设置了 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 中的任何一个,则当前工作目录被视为工作树的顶层。

请注意,即使该变量设置在某个目录的 ".git" 子目录的配置文件中,并且其值与该目录本身不同(例如,"/path/to/.git/config" 将 core.worktree 设置为 "/different/path"),它仍然会生效,这很可能是一种错误配置。在 "/path/to" 目录中运行 Git 命令仍将使用 "/different/path" 作为工作树的根目录,除非您知道自己在做什么(例如,您正在将相同索引的只读快照创建到与仓库通常工作树不同的位置),否则可能会导致混淆。

core.logAllRefUpdates

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

此信息可用于确定“两天前”某个分支的尖端提交是什么。

在关联了工作目录的仓库中,此值默认为 true;在裸仓库中,此值默认为 false。

core.repositoryFormatVersion

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

core.sharedRepository

当为 group(或 true)时,仓库在组内的多个用户之间共享(确保所有文件和对象都可被组写入)。当为 all(或 worldeverybody)时,仓库除了可被组共享外,所有用户都可读。当为 umask(或 false)时,Git 将使用 umask(2) 报告的权限。当为 0xxx 时(其中 0xxx 是八进制数),仓库中的文件将具有此模式值。0xxx 将覆盖用户的 umask 值(而其他选项仅覆盖用户 umask 值中请求的部分)。示例:0660 将使仓库对所有者和组可读写,但对其他用户不可访问(等同于 group,除非 umask 为例如 0022)。0640 是一个组可读但不可组写入的仓库。参见 git-init[1]。默认为 False。

core.warnAmbiguousRefs

如果为 true,则当您传递的引用名称不明确且可能与仓库中的多个引用匹配时,Git 将警告您。默认为 True。

core.compression

一个整数,范围为 -1..9,表示默认压缩级别。-1 是 zlib 的默认值。0 表示不压缩,1..9 是各种速度/大小的权衡,9 是最慢的。如果设置,这将为其他压缩变量提供默认值,例如 core.looseCompressionpack.compression

core.looseCompression

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

core.packedGitWindowSize

在单个映射操作中映射到内存中的 pack 文件字节数。更大的窗口大小可以使您的系统更快地处理少量大型 pack 文件。较小的窗口大小会因为对操作系统内存管理器的调用增加而对性能产生负面影响,但在访问大量大型 pack 文件时可能会提高性能。

如果在编译时设置了 NO_MMAP,则默认值为 1 MiB,否则在 32 位平台上为 32 MiB,在 64 位平台上为 1 GiB。这对于所有用户/操作系统来说都应该合理。您可能不需要调整此值。

支持常用的单位后缀 kmg

core.packedGitLimit

从 pack 文件同时映射到内存中的最大字节数。如果 Git 需要一次访问超过此数量的字节来完成操作,它将取消映射现有区域以回收进程内的虚拟地址空间。

在 32 位平台上默认为 256 MiB,在 64 位平台上为 32 TiB(实际无限)。这对于所有用户/操作系统来说都应该合理,除了最大的项目。您可能不需要调整此值。

支持常用的单位后缀 kmg

core.deltaBaseCacheLimit

每个线程用于缓存可能被多个差异化对象引用的基本对象的最大字节数。通过将整个解压缩后的基本对象存储在缓存中,Git 能够避免多次解包和解压缩频繁使用的基本对象。

在所有平台上默认为 96 MiB。这对于所有用户/操作系统来说都应该合理,除了最大的项目。您可能不需要调整此值。

支持常用的单位后缀 kmg

core.bigFileThreshold

被视为“大文件”的文件大小,如下所述,这会改变许多 Git 命令的行为,以及此类文件在仓库中的存储方式。默认值为 512 MiB。支持常用的单位后缀 kmg

超出配置限制的文件将

  • 以紧缩(deflated)形式存储在 packfile 中,不尝试进行增量压缩。

    设置此默认限制主要是为了考虑这种用例。有了它,大多数项目的源代码和其他文本文件将进行增量压缩,但较大的二进制媒体文件则不会。

    存储不带增量压缩的大文件可以避免过度的内存使用,但会稍微增加磁盘使用量。

  • 将被视为标记为“二进制”文件(参见 gitattributes[5])。例如,git-log[1]git-diff[1] 不会计算超出此限制的文件的差异。

  • 写入时通常会进行流式传输,这可以避免过度的内存使用,但会产生一些固定的开销。使用此功能的命令包括 git-archive[1]git-fast-import[1]git-index-pack[1]git-unpack-objects[1]git-fsck[1]

core.excludesFile

指定包含描述不应跟踪的路径模式的文件路径名,除了 .gitignore(按目录)和 .git/info/exclude。默认为 $XDG_CONFIG_HOME/git/ignore。如果 $XDG_CONFIG_HOME 未设置或为空,则使用 $HOME/.config/git/ignore。参见 gitignore[5]

core.askPass

一些交互式询问密码的命令(例如 svn 和 http 接口)可以通过此变量的值来指定使用外部程序。可以通过 GIT_ASKPASS 环境变量覆盖。如果未设置,则回退到 SSH_ASKPASS 环境变量的值,如果仍然失败,则使用简单的密码提示。外部程序应将合适的提示作为命令行参数,并将密码写入其标准输出 (STDOUT)。

core.attributesFile

除了 .gitattributes(按目录)和 .git/info/attributes 之外,Git 还会在此文件中查找属性(参见 gitattributes[5])。路径扩展方式与 core.excludesFile 相同。其默认值为 $XDG_CONFIG_HOME/git/attributes。如果 $XDG_CONFIG_HOME 未设置或为空,则使用 $HOME/.config/git/attributes

core.hooksPath

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

路径可以是绝对路径或相对路径。相对路径是相对于运行钩子的目录(参见 githooks[5] 的“DESCRIPTION”部分)。

当您希望集中配置 Git 钩子而不是按每个仓库配置时,或者作为对已更改默认钩子的 init.templateDir 的更灵活和集中化的替代方案时,此配置变量非常有用。

您还可以通过将 core.hooksPath 设置为 /dev/null 来完全禁用所有钩子。这通常只建议专家用户使用,并且可以按命令使用 git -c core.hooksPath=/dev/null ... 形式的配置参数来实现。

core.editor

诸如 committag 等允许您通过启动编辑器编辑消息的命令,在设置此变量且未设置环境变量 GIT_EDITOR 时,会使用此变量的值。参见 git-var[1]

core.commentChar
core.commentString

诸如 committag 等允许您编辑消息的命令,会将以该字符开头的行视为注释,并在编辑器返回后将其删除(默认为 #)。

如果设置为 "auto",git-commit 将选择一个不作为现有提交消息中任何行起始字符的字符。

请注意,这两个变量是彼此的别名,在现代 Git 版本中,您可以自由地将字符串(例如 //⁑⁕⁑)与 commentChar 一起使用。v2.45.0 之前的 Git 版本将忽略 commentString,但会拒绝由多个 ASCII 字节组成的 commentChar 值。如果您计划将配置与旧版本和新版本的 Git 一起使用,您可能需要同时指定两者。

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

尝试锁定单个引用时重试的时间长度,单位为毫秒。值为 0 表示完全不重试;-1 表示无限期尝试。默认值为 100(即,重试 100 毫秒)。

core.packedRefsTimeout

尝试锁定 packed-refs 文件时重试的时间长度,单位为毫秒。值为 0 表示完全不重试;-1 表示无限期尝试。默认值为 1000(即,重试 1 秒)。

core.pager

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

LESS 环境变量未设置时,Git 会将其设置为 FRX(如果设置了 LESS 环境变量,Git 不会对其进行任何更改)。如果您想选择性地覆盖 Git 对 LESS 的默认设置,您可以将 core.pager 设置为例如 less -S。这将由 Git 传递给 shell,shell 会将最终命令转换为 LESS=FRX less -S。环境变量不会设置 S 选项,但命令行会设置,指示 less 截断长行。类似地,将 core.pager 设置为 less -+F 将从命令行停用环境变量指定的 F 选项,从而停用 less 的“单屏退出”行为。可以为特定命令专门激活某些标志:例如,将 pager.blame 设置为 less -S 只会为 git blame 启用行截断。

同样,当 LV 环境变量未设置时,Git 会将其设置为 -c。您可以通过导出具有其他值的 LV 或将 core.pager 设置为 lv +c 来覆盖此设置。

core.whitespace

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

  • blank-at-eol 将行尾的尾随空白视为错误(默认启用)。

  • space-before-tab 将行初始缩进部分中紧跟制表符之前的空格字符视为错误(默认启用)。

  • indent-with-non-tab 将使用空格字符而非等效制表符缩进的行视为错误(默认不启用)。

  • tab-in-indent 将行初始缩进部分中的制表符视为错误(默认不启用)。

  • blank-at-eof 将文件末尾添加的空行视为错误(默认启用)。

  • trailing-spaceblank-at-eolblank-at-eof 的简写。

  • cr-at-eol 将行尾的回车符视为行终止符的一部分,即,有了它,如果回车符之前的字符不是空白字符,则 trailing-space 不会触发(默认不启用)。

  • tabwidth=<n> 表示一个制表符占据多少个字符位置;这与 indent-with-non-tab 以及 Git 修复 tab-in-indent 错误时相关。默认制表符宽度为 8。允许的值为 1 到 63。

core.fsync

一个逗号分隔的列表,包含仓库中在创建或修改时应通过 core.fsyncMethod 加固的组件。您可以通过在组件前加上 - 来禁用任何组件的加固。未加固的项目在系统非正常关机时可能会丢失。除非您有特殊要求,否则建议您将此选项留空或选择 committedaddedall 中的一个。

当遇到此配置时,组件集从平台默认值开始,禁用组件被移除,并添加额外组件。none 重置状态,从而忽略平台默认值。

空字符串将 fsync 配置重置为平台默认值。大多数平台上的默认值等同于 core.fsync=committed,-loose-object,这具有良好的性能,但在系统非正常关机时,存在丢失近期工作的风险。

  • none 清除 fsynced 组件集。

  • loose-object 加固以松散对象形式添加到仓库中的对象。

  • pack 加固以 packfile 形式添加到仓库中的对象。

  • pack-metadata 加固 packfile 位图和索引。

  • commit-graph 加固提交图文件。

  • index 在修改时加固索引。

  • objects 是一个聚合选项,等同于 loose-object,pack

  • reference 加固仓库中修改的引用。

  • derived-metadata 是一个聚合选项,等同于 pack-metadata,commit-graph

  • committed 是一个聚合选项,目前等同于 objects。此模式牺牲部分性能以确保通过 git commit 或类似命令提交到仓库的工作得到加固。

  • added 是一个聚合选项,目前等同于 committed,index。此模式牺牲额外的性能以确保 git add 等命令和类似操作的结果得到加固。

  • all 是一个聚合选项,同步上述所有单个组件。

core.fsyncMethod

一个值,指示 Git 将使用 fsync 及相关原语来加固仓库数据的策略。

  • fsync 使用 fsync() 系统调用或平台等效方法。

  • writeout-only 发出页缓存回写请求,但根据文件系统和存储硬件的不同,添加到仓库的数据在系统崩溃时可能不具有持久性。这是 macOS 上的默认模式。

  • batch 启用一种模式,该模式使用仅写入刷新将多个更新暂存在磁盘回写缓存中,然后在操作结束时对一个虚拟文件进行一次完整的 fsync,以触发磁盘缓存刷新。

    目前,batch 模式仅适用于松散对象文件。其他仓库数据像指定了 fsync 一样进行持久化。对于存储在 HFS+ 或 APFS 文件系统上的 macOS 仓库,以及存储在 NTFS 或 ReFS 文件系统上的 Windows 仓库,此模式预计与 fsync 一样安全。

core.fsyncObjectFiles

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

此设置影响以松散对象形式添加到 Git 仓库的数据。当设置为 true 时,Git 将发出 fsync 或类似的系统调用来刷新缓存,以便在系统非正常关机时,松散对象保持一致。

core.preloadIndex

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

这可以加速 git diffgit status 等操作,尤其是在像 NFS 这样缓存语义弱且 IO 延迟相对较高的文件系统上。启用后,Git 将并行执行索引与文件系统数据的比较,从而允许重叠的 IO 操作。默认为 true。

core.unsetenvvars

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

core.restrictinheritedhandles

仅限 Windows:覆盖派生进程是仅继承标准文件句柄(stdinstdoutstderr)还是所有句柄。可以是 autotruefalse。默认为 auto,这意味着在 Windows 7 及更高版本上为 true,在较旧的 Windows 版本上为 false

core.createObject

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

在某些文件系统/操作系统组合上,此方法不可靠。请在此处将此配置设置设置为 rename;但是,这将移除确保现有对象文件不会被覆盖的检查。

core.notesRef

显示提交消息时,也显示存储在给定引用中的备注。该引用必须是完全限定的。如果给定的引用不存在,这不是错误,但表示不应打印任何备注。

此设置默认为 "refs/notes/commits",并且可以通过 GIT_NOTES_REF 环境变量覆盖。参见 git-notes[1]

core.commitGraph

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

core.useReplaceRefs

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

core.multiPackIndex

使用多 pack 索引文件通过单个索引跟踪多个 packfile。有关更多信息,请参见 git-multi-pack-index[1]。默认为 true。

core.sparseCheckout

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

core.sparseCheckoutCone

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

core.abbrev

设置对象名称的缩写长度。如果未指定或设置为 "auto",则会根据仓库中 packed 对象的近似数量计算一个合适的值,希望足以使缩写对象名称在一段时间内保持唯一。如果设置为 "no",则不进行缩写,对象名称以完整长度显示。最小长度为 4。

core.maxTreeDepth

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

credential.helper

指定当需要用户名或密码凭据时要调用的外部助手;该助手可以查询外部存储以避免提示用户输入凭据。这通常是凭据助手的名称,可能带有参数,但也可能是带有参数的绝对路径,或者如果前面带有 !,则是 shell 命令。

请注意,可以定义多个助手。有关详细信息和示例,请参见 gitcredentials[7]

credential.interactive

默认情况下,当需要新凭据时,Git 和任何配置的凭据助手都会请求用户输入。如果存储的凭据仍然有效,许多这些助手会根据存储的凭据成功。为了避免 Git 的用户交互可能性,请将 credential.interactive=false。一些凭据助手也遵守此选项。

credential.useHttpPath

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

credential.sanitizePrompt

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

credential.protectProtocol

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

credential.username

如果网络认证未设置用户名,则默认使用此用户名。参见下面的 credential.<context>.* 和 gitcredentials[7]

credential.<url>.*

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

credentialCache.ignoreSIGHUP

告知 git-credential-cache—​daemon 忽略 SIGHUP 信号,而不是退出。

credentialStore.lockTimeoutMS

当git-credential-store尝试锁定凭据文件时,重试的毫秒数。值为0表示根本不重试;-1表示无限期重试。默认值为1000(即重试1秒)。

diff.autoRefreshIndex

当使用git diff与工作区文件进行比较时,不将仅统计信息的更改视为已更改。相反,静默运行git update-index --refresh以更新工作区中内容与索引中内容匹配的路径的缓存统计信息。此选项默认为true。请注意,这仅影响git diff Porcelain(高级命令),而不影响git diff-files等底层diff命令。

diff.dirstat

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

changes

通过计算从源文件中删除或添加到目标文件中的行数来计算目录统计数字。这会忽略文件中纯粹的代码移动量。换句话说,文件中的行重新排列不会像其他更改那样被计算在内。当未给定参数时,这是默认行为。

lines

通过执行常规的基于行的差异分析,并汇总删除/添加的行数来计算目录统计数字。(对于二进制文件,计算64字节的块,因为二进制文件没有自然意义上的行)。这是一种比changes行为更昂贵的--dirstat行为,但它会将文件内重新排列的行与其他更改一样计算在内。结果输出与您从其他--*stat选项获得的结果一致。

files

通过计算更改文件的数量来计算目录统计数字。在目录统计分析中,每个更改的文件权重相等。这是计算成本最低的--dirstat行为,因为它根本不需要查看文件内容。

cumulative

子目录中的更改也计入父目录。请注意,使用cumulative时,报告的百分比总和可能超过100%。默认(非累积)行为可以通过noncumulative参数指定。

<limit>

一个整数参数,指定一个截止百分比(默认为 3%)。对更改贡献低于此百分比的目录不会显示在输出中。

示例:以下将计算更改的文件,同时忽略更改文件总量少于10%的目录,并将子目录计数累积到父目录中:files,10,cumulative

diff.statNameWidth

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

diff.statGraphWidth

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

diff.context

生成差异时显示<n>行上下文,而非默认的3行。此值会被-U选项覆盖。

diff.interHunkContext

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

diff.external

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

diff.trustExitCode

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

diff.ignoreSubmodules

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

diff.mnemonicPrefix

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

git diff

比较(i)索引和(w)工作树;

git diff HEAD

比较(c)提交和(w)工作树;

git diff --cached

比较(c)提交和(i)索引;

git diff HEAD:<file1> <file2>

比较一个(o)对象和(w)工作树实体;

git diff --no-index <a> <b>

比较两个非 Git 对象 <a><b>

diff.noPrefix

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

diff.srcPrefix

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

diff.dstPrefix

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

diff.relative

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

diff.orderFile

指定差异中文件排序方式的文件。详情请参见git-diff[1]-O选项。如果diff.orderFile是相对路径名,则将其视为相对于工作树根目录的路径。

diff.renameLimit

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

diff.renames

Git 是否以及如何检测重命名。如果设置为false,则禁用重命名检测。如果设置为true,则启用基本重命名检测。如果设置为copiescopy,Git 也会检测复制。默认为true。请注意,这仅影响git-diff[1]git-log[1]git diff Porcelain(高级命令),而不影响git-diff-files[1]等底层命令。

diff.suppressBlankEmpty

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

diff.submodule

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

diff.wordRegex

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

diff.<driver>.command

自定义差异驱动命令。详见gitattributes[5]

diff.<driver>.trustExitCode

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

diff.<driver>.xfuncname

差异驱动程序应该用于识别hunk头部的正则表达式。也可以使用内置模式。详见gitattributes[5]

diff.<driver>.binary

将此选项设置为true,使差异驱动程序将文件视为二进制文件。详见gitattributes[5]

diff.<driver>.textconv

差异驱动程序应调用以生成文件文本转换版本的命令。转换结果用于生成人类可读的差异。详见gitattributes[5]

diff.<driver>.wordRegex

差异驱动程序应该用于在行中分割单词的正则表达式。详见gitattributes[5]

diff.<driver>.cachetextconv

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

diff.indentHeuristic

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

diff.algorithm

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

default
myers

基本的贪婪差异算法。目前,这是默认值。

minimal

花费额外时间以确保生成最小的差异。

patience

生成补丁时使用“patience diff”算法。

histogram

此算法扩展了 patience 算法以“支持低出现率的常见元素”。

diff.wsErrorHighlight

在差异的contextoldnew行中高亮显示空白错误。多个值用逗号分隔,none重置先前的值,default将列表重置为newallold,new,context的简写。空白错误将使用color.diff.whitespace着色。命令行选项--ws-error-highlight=<kind>会覆盖此设置。

diff.colorMoved

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

diff.colorMovedWS

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

diff.tool

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

diff.guitool

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

  • araxis

  • bc

  • codecompare

  • deltawalker

  • diffmerge

  • diffuse

  • ecmerge

  • emerge

  • examdiff

  • guiffy

  • gvimdiff

  • kdiff3

  • kompare

  • meld

  • nvimdiff

  • opendiff

  • p4merge

  • smerge

  • tkdiff

  • vimdiff

  • vscode

  • winmerge

  • xxdiff

difftool.<tool>.cmd

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

详见git-difftool[1]中的--tool=<tool>选项。

difftool.<tool>.path

覆盖给定工具的路径。这在您的工具不在PATH中时很有用。

difftool.trustExitCode

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

详见git-difftool[1]中的--trust-exit-code选项。

difftool.prompt

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

difftool.guiDefault

设置为true以默认使用diff.guitool(等同于指定--gui参数),或设置为auto以根据是否存在DISPLAY环境变量值来选择diff.guitooldiff.tool。默认值为false,在这种情况下,必须显式提供--gui参数才能使用diff.guitool

extensions.*

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

compatObjectFormat

指定要使用的兼容哈希算法。可接受的值是sha1sha256。指定的值必须与extensions.objectFormat的值不同。这允许对象格式与此compatObjectFormat匹配的Git存储库之间进行客户端级别的互操作性。特别是,当完全实现时,可以从对象格式与compatObjectFormat匹配的存储库进行推送和拉取。此外,除了使用objectFormat编码的oid之外,还可以使用compatObjectFormat编码的oid在本地指定对象。

noop

此扩展完全不改变git的行为。它仅用于测试format-1兼容性。

由于历史原因,无论core.repositoryFormatVersion设置如何,此扩展都受尊重。

noop-v1

此扩展完全不改变git的行为。它仅用于测试format-1兼容性。

objectFormat

指定要使用的哈希算法。可接受的值是sha1sha256。如果未指定,则假定为sha1

请注意,此设置仅应由git-init[1]git-clone[1]设置。尝试在初始化后更改它将不起作用,并会产生难以诊断的问题。

partialClone

启用时,表示仓库是使用部分克隆创建的(或后续执行了部分抓取),并且远程可能省略了发送某些不需要的对象。这样的远程被称为“承诺远程”,它承诺所有此类省略的对象将来都可以从它那里抓取。

此键的值是承诺远程的名称。

由于历史原因,无论core.repositoryFormatVersion设置如何,此扩展都受尊重。

preciousObjects

如果启用,表示仓库中的对象**不得**删除(例如,通过git-prunegit repack -d)。

由于历史原因,无论core.repositoryFormatVersion设置如何,此扩展都受尊重。

refStorage

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

  • files 表示带有 packed-refs 的松散文件。这是默认值。

  • reftable 表示 reftable 格式。此格式是实验性的,其内部结构可能会更改。

请注意,此设置仅应由git-init[1]git-clone[1]设置。尝试在初始化后更改它将不起作用,并会产生难以诊断的问题。

relativeWorktrees

如果启用,表示至少有一个工作树已使用相对路径链接。如果工作树使用--relative-paths选项或将worktree.useRelativePaths配置设置为true创建或修复,则会自动设置。

worktreeConfig

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

启用此扩展时,必须小心将某些值从公共配置文件移动到主工作树的config.worktree文件(如果存在)中

  • core.worktree必须从$GIT_COMMON_DIR/config移动到$GIT_COMMON_DIR/config.worktree

  • 如果core.bare为真,则必须将其从$GIT_COMMON_DIR/config移动到$GIT_COMMON_DIR/config.worktree

根据您对每个工作树可定制的稀疏检出设置的需求,调整core.sparseCheckoutcore.sparseCheckoutCone的位置也可能是有益的。默认情况下,git sparse-checkout内置命令会启用此扩展,为每个工作树分配这些配置值,并使用$GIT_DIR/info/sparse-checkout文件独立指定每个工作树的稀疏性。详见git-sparse-checkout[1]

+ 由于历史原因,无论core.repositoryFormatVersion设置如何,此扩展都受尊重。

fastimport.unpackLimit

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

feature.*

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

feature.experimental

启用Git新引入且正在考虑作为未来默认值的配置选项。此处包含的配置设置可能会随每个版本(包括次要版本更新)的发布而添加或删除。这些设置可能存在意外的交互,因为它们是如此新颖。如果您有兴趣就实验性功能提供反馈,请启用此设置。新的默认值是

  • fetch.negotiationAlgorithm=skipping 可能通过一次跳过更多提交来改善抓取协商时间,减少往返次数。

  • pack.useBitmapBoundaryTraversal=true 可能通过遍历更少的对象来改善位图遍历时间。

  • pack.allowPackReuse=multi 可能通过重用来自多个包而非仅仅一个包的对象来改善创建包所需的时间。

feature.manyFiles

启用优化包含大量文件的仓库的配置选项。当文件数量众多时,git statusgit checkout等命令可能会变慢,这些新默认设置可以提高性能

  • index.skipHash=true 通过不计算尾随校验和来加速索引写入。请注意,这会导致早于2.13.0的Git版本拒绝解析索引,而早于2.40.0的Git版本会在git fsck期间报告索引损坏。

  • index.version=4 启用索引中的路径前缀压缩。

  • core.untrackedCache=true 启用未跟踪缓存。此设置假定您的机器上mtime正常工作。

fetch.recurseSubmodules

此选项控制git fetch(以及git pull中底层的fetch)是否会递归抓取到已填充的子模块中。此选项可以设置为布尔值或on-demand。设置为布尔值时,如果设置为true,则fetch和pull的行为会无条件地递归到子模块中;如果设置为false,则完全不递归。当设置为on-demand时,fetch和pull仅在其父项目检索到更新子模块引用的提交时,才会递归到已填充的子模块中。默认为on-demand,如果设置了submodule.recurse,则默认为其值。

fetch.fsckObjects

如果设置为true,git-fetch-pack将检查所有抓取的对象。请参见transfer.fsckObjects了解检查内容。默认为false。如果未设置,则使用transfer.fsckObjects的值。

fetch.fsck.<msg-id>

行为类似于fsck.<msg-id>,但由git-fetch-pack[1]使用而非git-fsck[1]。详见fsck.<msg-id>文档。

fetch.fsck.skipList

行为类似于fsck.skipList,但由git-fetch-pack[1]使用而非git-fsck[1]。详见fsck.skipList文档。

fetch.unpackLimit

如果通过Git原生传输抓取的对象数量低于此限制,则对象将被解包为松散对象文件。但是,如果接收到的对象数量等于或超过此限制,则接收到的包将被存储为一个包,并在添加任何缺失的增量基数之后。从推送中存储包可以使推送操作更快完成,尤其是在慢速文件系统上。如果未设置,则使用transfer.unpackLimit的值。

fetch.prune

如果为true,fetch将自动表现为在命令行上给定了--prune选项。另请参阅remote.<name>.prunegit-fetch[1]的PRUNING部分。

fetch.pruneTags

如果为true,并且未设置refs/tags/*:refs/tags/*引用规范,fetch将自动表现为提供了该规范进行修剪。这允许同时设置此选项和fetch.prune以保持与上游引用的一对一映射。另请参阅remote.<name>.pruneTagsgit-fetch[1]的PRUNING部分。

fetch.all

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

fetch.output

控制引用更新状态的打印方式。有效值为fullcompact。默认值为full。详见git-fetch[1]的OUTPUT部分。

fetch.negotiationAlgorithm

控制在协商服务器要发送的 packfile 内容时,如何发送有关本地仓库中提交的信息。设置为“consecutive”以使用遍历连续提交并检查每个提交的算法。设置为“skipping”以使用跳过提交以更快收敛的算法,但这可能导致 packfile 大于必要的大小;或者设置为“noop”以完全不发送任何信息,这几乎肯定会导致 packfile 大于必要的大小,但会跳过协商步骤。设置为“default”以覆盖之前进行的设置并使用默认行为。默认通常是“consecutive”,但如果 feature.experimental 为 true,则默认是“skipping”。未知值将导致 git fetch 出错。

另请参阅 git-fetch[1]--negotiate-only--negotiation-tip 选项。

fetch.showForcedUpdates

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

fetch.parallel

指定同时运行的最大抓取操作数(子模块,或当 git-fetch[1]--multiple 选项生效时,对远程仓库)。

值 0 将给出一些合理的默认值。如果未设置,则默认为 1。

对于子模块,此设置可以使用 submodule.fetchJobs 配置来覆盖。

fetch.writeCommitGraph

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

fetch.bundleURI

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

如果您修改此值并且您的仓库具有 fetch.bundleCreationToken 值,则在从新的 bundle URI 抓取之前,请删除该 fetch.bundleCreationToken 值。

fetch.bundleCreationToken

当使用 fetch.bundleURI 从使用“creationToken”启发式方法的 bundle 列表中增量抓取时,此配置值存储已下载 bundle 的最大 creationToken 值。如果公布的 creationToken 不严格大于此值,则此值用于阻止将来下载 bundle。

创建令牌值由提供特定 bundle URI 的服务方选择。如果您修改 fetch.bundleURI 中的 URI,请务必在抓取之前移除 fetch.bundleCreationToken 的值。

filter.<driver>.clean

用于在提交时将工作树文件内容转换为 blob 的命令。详见 gitattributes[5]

filter.<driver>.smudge

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

format.attach

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

format.from

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

format.forceInBodyFrom

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

format.numbered

一个布尔值,可以启用或禁用补丁主题中的序列号。它默认为“auto”,仅当有多个补丁时才启用。通过设置为“true”或“false”,可以为所有消息启用或禁用它。详见 git-format-patch[1] 中的 --numbered 选项。

format.headers

邮件提交补丁中要包含的额外电子邮件头。详见 git-format-patch[1]

format.to
format.cc

邮件提交补丁中要包含的额外收件人。详见 git-format-patch[1] 中的 --to 和 --cc 选项。

format.subjectPrefix

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

format.coverFromDescription

`format-patch` 确定封面信函的哪些部分将使用分支描述填充的默认模式。详见 git-format-patch[1] 中的 --cover-from-description 选项。

format.signature

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

format.signatureFile

与 `format.signature` 作用相同,但此变量指定的文件内容将用作签名。

format.suffix

`format-patch` 的默认设置是输出带有 .patch 后缀的文件。使用此变量可以更改该后缀(如果需要,请确保包含点)。

format.encodeEmailHeaders

对于电子邮件传输,使用“Q-编码”(RFC 2047 中描述)对包含非 ASCII 字符的电子邮件头进行编码。默认为 true。

format.pretty

`log`/`show`/`whatchanged` 命令的默认美观格式。详见 git-log[1]git-show[1]git-whatchanged[1]

format.thread

git format-patch 的默认线程样式。可以是布尔值,也可以是 shallowdeepshallow 线程将每封邮件作为对系列头部的回复,其中头部按此顺序从封面信函、--in-reply-to 和第一封补丁邮件中选择。deep 线程将每封邮件作为对上一封的回复。true 布尔值与 shallow 相同,false 值禁用线程。

format.signOff

一个布尔值,允许您默认启用 format-patch 的 -s/--signoff 选项。注意:Signed-off-by 尾行添加到补丁中应该是有意识的行为,表示您证明您有权在相同的开源许可下提交此工作。有关进一步讨论,请参阅 SubmittingPatches 文档。

format.coverLetter

一个布尔值,控制在调用 format-patch 时是否生成封面信函,但也可以设置为“auto”,仅当有多个补丁时才生成封面信函。默认为 false。

format.outputDirectory

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

format.filenameMaxLength

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

format.useAutoBase

一个布尔值,允许您默认启用 format-patch 的 --base=auto 选项。也可以设置为“whenAble”,以便在可用合适基准时启用 --base=auto,否则跳过添加基准信息,而不会导致格式化失败。

format.notes

为 `format-patch` 的 --notes 选项提供默认值。接受布尔值,或指定从何处获取备注的 ref。如果为 false,`format-patch` 默认为 --no-notes。如果为 true,`format-patch` 默认为 --notes。如果设置为非布尔值,`format-patch` 默认为 --notes=<ref>,其中 ref 是该非布尔值。默认为 false。

如果希望使用 ref refs/notes/true,请使用该字面值。

此配置可以多次指定,以允许包含多个备注引用。在这种情况下,其行为类似于传入多个 --[no-]notes[=] 选项。也就是说,值为 true 将显示默认备注,值为 <ref> 也将显示该备注引用的备注,而值为 false 将否定先前的配置并且不显示备注。

例如,

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

将只显示来自 refs/notes/bar 的备注。

format.mboxrd

一个布尔值,当使用 --stdout 以转义“^>+From ”行时,它会启用健壮的“mboxrd”格式。

format.noprefix

如果设置,则不在补丁中显示任何源或目标前缀。这相当于 git diff 使用的 diff.noprefix 选项(但 format-patch 不支持)。请注意,通过设置此选项,您生成的任何补丁的接收者将不得不使用 -p0 选项来应用它们。

fsck.<msg-id>

在 fsck 期间,Git 可能会发现旧数据的问题,这些数据不会由当前版本的 Git 生成,如果设置了 transfer.fsckObjects,也不会通过网络发送。此功能旨在支持处理包含此类数据的旧仓库。

设置 fsck.<msg-id> 将被 git-fsck[1] 识别,但要接受此类数据的推送,请设置 receive.fsck.<msg-id>;要克隆或抓取它,请设置 fetch.fsck.<msg-id>

为简洁起见,本文档的其余部分讨论 fsck.*,但同样适用于相应的 receive.fsck.*fetch.fsck.* 变量。

color.uicore.editor 等变量不同,receive.fsck.<msg-id>fetch.fsck.<msg-id> 变量在未设置时不会回退到 fsck.<msg-id> 配置。要在不同情况下统一配置相同的 fsck 设置,所有这三个变量必须设置为相同的值。

当设置 fsck.<msg-id> 时,可以通过配置 fsck.<msg-id> 设置将错误切换为警告,反之亦然,其中 <msg-id> 是 fsck 消息 ID,值是 errorwarnignore 之一。为方便起见,fsck 会在错误/警告前加上消息 ID,例如,“missingEmail: invalid author/committer line - missing email”意味着设置 fsck.missingEmail = ignore 将隐藏该问题。

通常,最好使用 fsck.skipList 枚举存在问题的现有对象,而不是列出这些有问题对象共有的要忽略的损坏类型,因为后者将允许相同损坏的新实例不被注意。

设置未知的 fsck.<msg-id> 值将导致 fsck 终止,但对 receive.fsck.<msg-id>fetch.fsck.<msg-id> 执行相同操作只会导致 Git 发出警告。

有关 <msg-id> 支持的值,请参阅 git-fsck[1]Fsck Messages 部分。

fsck.skipList

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

当一个已建立的项目即使早期提交包含可以安全忽略的错误(例如无效的提交者电子邮件地址)也应被接受时,此功能非常有用。注意:损坏的对象不能通过此设置跳过。

fsck.<msg-id> 类似,此变量也有相应的 receive.fsck.skipListfetch.fsck.skipList 变体。

color.uicore.editor 等变量不同,receive.fsck.skipListfetch.fsck.skipList 变量在未设置时不会回退到 fsck.skipList 配置。要在不同情况下统一配置相同的 fsck 设置,所有这三个变量必须设置为相同的值。

旧版本的 Git(2.20 之前)曾记载对象名称列表应排序。但这从未是强制要求;对象名称可以以任何顺序出现,但在读取列表时,我们跟踪列表是否已排序,以用于内部二进制搜索实现,这可以为已排序的列表节省一些工作。除非您有一个庞大的列表,否则没有理由特意预先排序列表。Git 2.20 版本之后,改用哈希实现,因此现在没有理由预先排序列表。

fsmonitor.allowRemote

默认情况下,fsmonitor 守护进程拒绝与网络挂载的仓库一起工作。将 fsmonitor.allowRemote 设置为 true 将覆盖此行为。仅当 core.fsmonitor 设置为 true 时才生效。

fsmonitor.socketDir

此 Mac OS 特定的选项,如果设置,指定用于在 fsmonitor 守护进程和各种 Git 命令之间进行通信的 Unix 域套接字创建的目录。该目录必须位于本地 Mac OS 文件系统上。仅当 core.fsmonitor 设置为 true 时才生效。

gc.aggressiveDepth

git gc --aggressive 使用的 delta 压缩算法中使用的深度参数。默认值为 50,这是在不使用 --aggressive--depth 选项的默认值。

详见 git-repack[1]--depth 选项的文档。

gc.aggressiveWindow

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

详见 git-repack[1]--window 选项的文档。

gc.auto

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

将其设置为 0 不仅会禁用基于松散对象数量的自动打包,还会禁用 git gc --auto 在其他情况下用于确定是否有工作要做的任何其他启发式方法,例如 gc.autoPackLimit

gc.autoPackLimit

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

请参阅下面的 gc.bigPackThreshold 配置变量。使用时,它将影响自动打包限制的工作方式。

gc.autoDetach

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

gc.bigPackThreshold

如果非零,当运行 git gc 时,所有大于此限制的非 cruft 包都将被保留。这与 --keep-largest-pack 非常相似,只是所有达到阈值的非 cruft 包都被保留,而不仅仅是最大的包。默认为零。支持常见的单位后缀 kmg

请注意,如果保留的包数量超过 gc.autoPackLimit,此配置变量将被忽略,除基础包外的所有包都将被重新打包。在此之后,包的数量应低于 gc.autoPackLimit,并且 gc.bigPackThreshold 应再次生效。

如果 git repack 顺利运行所需的估计内存量不可用,并且未设置 gc.bigPackThreshold,则最大的包也将被排除(这相当于使用 git gc--keep-largest-pack)。

gc.writeCommitGraph

如果为 true,则在运行 git-gc[1] 时,gc 将重写提交图文件。当使用 git gc --auto 时,如果需要进行清理,提交图将更新。默认为 true。详见 git-commit-graph[1]

gc.logExpiry

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

gc.packRefs

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

gc.cruftPacks

将不可达对象存储在 cruft 包中(参见 git-repack[1]),而不是作为松散对象。默认为 true

gc.maxCruftSize

重新打包时限制新 cruft 包的大小。除了 --max-cruft-size 之外,如果也指定了此选项,则命令行选项优先。详见 git-repack[1]--max-cruft-size 选项。

gc.pruneExpire

当运行 git gc 时,它将调用 prune --expire 2.weeks.ago(如果通过 gc.cruftPacks--cruft 使用 cruft 包,则还会调用 repack --cruft --cruft-expiration 2.weeks.ago)。使用此配置变量可以覆盖宽限期。值“now”可用于禁用此宽限期并始终立即修剪不可达对象,或使用“never”来禁止修剪。此功能有助于防止 git gc 与另一个写入仓库的进程并发运行时发生损坏;详见 git-gc[1] 的“NOTES”部分。

gc.worktreePruneExpire

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

gc.reflogExpire
gc.<pattern>.reflogExpire

git reflog expire 会删除早于此时间的 reflog 条目;默认为 90 天。值“now”会立即使所有条目过期,而“never”会完全禁止过期。中间带有“<pattern>”(例如“refs/stash”)时,此设置仅适用于匹配该模式的引用。

gc.reflogExpireUnreachable
gc.<pattern>.reflogExpireUnreachable

git reflog expire 会删除早于此时间且无法从当前尖端到达的 reflog 条目;默认为 30 天。值“now”会立即使所有条目过期,而“never”会完全禁止过期。中间带有“<pattern>”(例如“refs/stash”)时,此设置仅适用于匹配该模式的引用。

这些类型的条目通常是使用 git commit --amendgit rebase 的结果,并且是修订或变基发生之前的提交。由于这些更改不是当前项目的一部分,大多数用户会希望它们更快过期,这就是为什么默认值比 gc.reflogExpire 更激进的原因。

gc.recentObjectsHook

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

输出必须每行包含一个十六进制对象 ID,且不得包含其他内容。在仓库中找不到的对象将被忽略。支持多个钩子,但所有钩子都必须成功退出,否则操作(无论是生成 cruft 包还是解包不可达对象)将被中止。

gc.repackFilter

重新打包时,使用指定的过滤器将某些对象移动到单独的 packfile 中。详见 git-repack[1]--filter=<filter-spec> 选项。

gc.repackFilterTo

在重新打包和使用过滤器时(参见 gc.repackFilter),指定的位置将用于创建包含过滤掉的对象的 packfile。警告: 指定的位置应该可访问,例如使用 Git 备用机制,否则 Git 可能会认为仓库已损坏,因为它可能无法访问该 packfile 中的对象。详见 git-repack[1]--filter-to=<dir> 选项以及 gitrepository-layout[5]objects/info/alternates 部分。

gc.rerereResolved

当运行 git rerere gc 时,您之前解决的冲突合并记录将保留这么天。您也可以使用更具可读性的“1.month.ago”等。默认是 60 天。详见 git-rerere[1]

gc.rerereUnresolved

当运行 git rerere gc 时,您尚未解决的冲突合并记录将保留这么天。您也可以使用更具可读性的“1.month.ago”等。默认是 15 天。详见 git-rerere[1]

gitcvs.commitMsgAnnotation

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

gitcvs.enabled

是否为此存储库启用 CVS 服务器接口。详见 git-cvsserver[1]

gitcvs.logFile

日志文件的路径,CVS 服务器接口将在此处记录各种信息。详见 git-cvsserver[1]

gitcvs.usecrlfattr

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

gitcvs.allBinary

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

gitcvs.dbName

git-cvsserver 用于缓存从 Git 存储库派生的修订信息的数据库。确切含义取决于所使用的数据库驱动程序,对于 SQLite(默认驱动程序),这是一个文件名。支持变量替换(详见 git-cvsserver[1])。不能包含分号(;)。默认值:%Ggitcvs.%m.sqlite

gitcvs.dbDriver

使用的 Perl DBI 驱动程序。您可以在此处指定任何可用的驱动程序,但它可能无法工作。git-cvsserver 已经过 DBD::SQLite 测试,据报与 DBD::Pg 兼容,但据报DBD::mysql 兼容。实验性功能。不能包含双冒号(:)。默认值:SQLite。详见 git-cvsserver[1]

gitcvs.dbUser
gitcvs.dbPass

数据库用户和密码。仅在设置 gitcvs.dbDriver 时有用,因为 SQLite 没有数据库用户和/或密码的概念。gitcvs.dbUser 支持变量替换(详见 git-cvsserver[1])。

gitcvs.dbTableNamePrefix

数据库表名前缀。添加到所用任何数据库表名的前面,允许单个数据库用于多个存储库。支持变量替换(详见 git-cvsserver[1])。任何非字母字符都将替换为下划线。

除了 gitcvs.usecrlfattrgitcvs.allBinary 之外,所有 gitcvs 变量也可以指定为 gitcvs.<access_method>.<varname>(其中 access_method 是“ext”和“pserver”之一),使它们仅适用于给定的访问方法。

gitweb.category
gitweb.description
gitweb.owner
gitweb.url

详见 gitweb[1]

gitweb.avatar
gitweb.blame
gitweb.grep
gitweb.highlight
gitweb.patches
gitweb.pickaxe
gitweb.remote_heads
gitweb.showSizes
gitweb.snapshot

详见 gitweb.conf[5]

gpg.program

在创建或验证 PGP 签名时,使用此自定义程序而不是在 $PATH 中找到的“gpg”程序。该程序必须支持与 GPG 相同的命令行接口,即,要验证分离签名,运行“gpg --verify $signature - <$file”,程序预期通过退出代码 0 来表示签名有效。要生成 ASCII 编码的分离签名,将要签名的内容通过标准输入传递给“gpg -bsau $key”,程序预期将其结果发送到标准输出。

gpg.format

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

有关签名格式,请参阅 gitformat-signature[5],该格式根据所选的 gpg.format 而异。

gpg.<format>.program

使用此选项自定义您选择的签名格式所使用的程序。(详见 gpg.programgpg.formatgpg.program 仍然可以作为 gpg.openpgp.program 的旧有同义词使用。gpg.x509.program 的默认值是“gpgsm”,gpg.ssh.program 的默认值是“ssh-keygen”。

gpg.minTrustLevel

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

  • undefined

  • never

  • marginal

  • fully

  • ultimate

gpg.ssh.defaultKeyCommand

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

gpg.ssh.allowedSignersFile

一个包含您愿意信任的 SSH 公钥的文件。该文件包含一行或多行主体,后跟一个 SSH 公钥。例如:user1@example.com,user2@example.com ssh-rsa AAAAX1... 详见 ssh-keygen(1) 的“ALLOWED SIGNERS”部分。主体仅用于识别密钥,并在验证签名时可用。

SSH 没有像 GPG 那样的信任级别概念。为了区分有效签名和受信任签名,当公钥存在于 allowedSignersFile 中时,签名验证的信任级别设置为 fully。否则,信任级别为 undefined,并且 git verify-commit/tag 将失败。

此文件可以设置在存储库之外的位置,并且每个开发者都维护自己的信任存储。中央存储库服务器可以根据具有推送权限的 SSH 密钥自动生成此文件,以验证代码。在企业环境中,此文件可能由已处理开发者 SSH 密钥的自动化系统在全球位置生成。

只允许签名提交的存储库可以将此文件存储在存储库本身中,使用相对于工作树顶层的路径。这样,只有持有有效密钥的提交者才能在密钥环中添加或更改密钥。

自 OpenSSH 8.8 起,此文件允许使用 valid-after 和 valid-before 选项指定密钥生命周期。如果签名密钥在签名创建时有效,Git 将把签名标记为有效。这允许用户更改签名密钥而不会使所有以前的签名失效。

使用带有 cert-authority 选项的 SSH CA 密钥(详见 ssh-keygen(1) 的“CERTIFICATES”部分)也是有效的。

gpg.ssh.revocationFile

SSH KRL 或已撤销公钥列表(不带主体前缀)。详见 ssh-keygen(1)。如果在此文件中找到公钥,则该公钥将始终被视为信任级别为“never”,并且签名将显示为无效。

grep.lineNumber

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

grep.column

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

grep.patternType

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

grep.extendedRegexp

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

grep.threads

要使用的 grep 工作线程数。如果未设置(或设置为 0),Git 将使用与可用逻辑核心数一样多的线程。

grep.fullName

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

grep.fallbackToNoIndex

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

gui.commitMsgWidth

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

gui.diffContext

指定 git-gui[1] 进行 diff 调用时应使用多少上下文行。默认值为“5”。

gui.displayUntracked

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

gui.encoding

指定 git-gui[1]gitk[1] 中显示文件内容的默认字符编码。可以通过为相关文件设置 encoding 属性来覆盖它(详见 gitattributes[5])。如果未设置此选项,工具将默认使用区域设置编码。

gui.matchTrackingBranch

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

gui.newBranchTemplate

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

gui.pruneDuringFetch

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

gui.trustmtime

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

gui.spellingDictionary

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

gui.fastCopyBlame

如果为 true,git gui blame 将使用 -C 而不是 -C -C 进行原始位置检测。这使得在大型存储库上的 blame 操作显著加快,代价是副本检测不那么彻底。

gui.copyBlameThreshold

指定在 git gui blame 原始位置检测中使用的阈值,以字母数字字符衡量。有关副本检测的更多信息,请参阅 git-blame[1] 手册。

gui.blamehistoryctx

指定从 git gui blame 调用 Show History Context 菜单项时,gitk[1] 中为选定提交显示的历史上下文的半径(以天为单位)。如果此变量设置为零,则显示整个历史。

guitool.<name>.cmd

指定当 git-gui[1] Tools 菜单中的相应项被调用时要执行的 shell 命令行。此选项对于每个工具都是强制性的。该命令从工作目录的根目录执行,并且在环境中接收工具名称为 GIT_GUITOOL,当前选定文件名为 FILENAME,当前分支名为 CUR_BRANCH(如果 HEAD 分离,CUR_BRANCH 为空)。

guitool.<name>.needsFile

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

guitool.<name>.noConsole

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

guitool.<name>.noRescan

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

guitool.<name>.confirm

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

guitool.<name>.argPrompt

向用户请求一个字符串参数,并通过 ARGS 环境变量将其传递给工具。由于请求参数意味着确认,因此如果启用此选项,confirm 选项将无效。如果选项设置为 trueyes1,对话框将使用内置的通用提示;否则将使用变量的确切值。

guitool.<name>.revPrompt

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

guitool.<name>.revUnmerged

仅在 revPrompt 子对话框中显示未合并的分支。这对于类似 merge 或 rebase 的工具很有用,但不适用于 checkout 或 reset 等。

guitool.<name>.title

指定提示对话框的标题。默认是工具名称。

guitool.<name>.prompt

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

help.browser

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

help.format

覆盖 git-help[1] 使用的默认帮助格式。支持 maninfowebhtml 值。man 是默认值。webhtml 相同。

help.autoCorrect

如果 Git 检测到拼写错误并且能够识别出一个与错误类似的有效命令,Git 将尝试建议正确的命令,甚至自动运行建议。可能的配置值有:

  • 0, "false", "off", "no", "show": 显示建议命令(默认)。

  • 1, "true", "on", "yes", "immediate": 立即运行建议命令。

  • 大于 1 的正数:在指定的十分之一秒后运行建议命令(0.1 秒)。

  • "never": 不运行或显示任何建议命令。

  • "prompt": 显示建议并提示确认是否运行命令。

help.htmlPath

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

http.proxy

覆盖 HTTP 代理,通常使用 http_proxyhttps_proxyall_proxy 环境变量配置(详见 curl(1))。除了 curl 理解的语法之外,还可以指定一个只有用户名但没有密码的代理字符串,在这种情况下,Git 将以获取其他凭据相同的方式尝试获取密码。更多信息请参见 gitcredentials[7]。因此语法是 [protocol://][user[:password]@]proxyhost[:port][/path]。这可以在每个远程仓库的基础上被覆盖;详见 remote.<name>.proxy

无论如何配置,任何代理都必须完全透明,不得以任何方式修改、转换或缓冲请求或响应。已知不完全透明的代理会导致 Git 出现各种形式的故障。

http.proxyAuthMethod

设置用于对 HTTP 代理进行身份验证的方法。这仅在配置的代理字符串包含用户名部分(即 user@hostuser@host:port 形式)时生效。这可以在每个远程仓库的基础上被覆盖;详见 remote.<name>.proxyAuthMethod。两者都可以通过 GIT_HTTP_PROXY_AUTHMETHOD 环境变量覆盖。可能的值有:

  • anyauth - 自动选择合适的认证方法。假定代理以 407 状态码和至少一个包含支持的认证方法的 Proxy-authenticate 头部来响应未经认证的请求。这是默认值。

  • basic - HTTP 基本认证

  • digest - HTTP Digest 认证;这可以防止密码以明文形式传输到代理。

  • negotiate - GSS-Negotiate 认证(与 curl(1) 的 --negotiate 选项比较)

  • ntlm - NTLM 认证(与 curl(1) 的 --ntlm 选项比较)

http.proxySSLCert

存储用于 HTTPS 代理认证的客户端证书文件的路径名。可以通过 GIT_PROXY_SSL_CERT 环境变量覆盖。

http.proxySSLKey

存储用于 HTTPS 代理认证的私钥文件的路径名。可以通过 GIT_PROXY_SSL_KEY 环境变量覆盖。

http.proxySSLCertPasswordProtected

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

http.proxySSLCAInfo

包含证书束的文件的路径名,该证书束在使用 HTTPS 代理时应用于验证代理。可以通过 GIT_PROXY_SSL_CAINFO 环境变量覆盖。

http.emptyAuth

尝试不请求用户名或密码的认证。这可以用于尝试 GSS-Negotiate 认证,而无需在 URL 中指定用户名,因为 libcurl 通常需要用户名进行认证。

http.proactiveAuth

尝试认证,而不首先进行未经认证的尝试并接收 401 响应。这可用于确保所有请求都经过认证。如果 http.emptyAuth 设置为 true,此值无效。

如果使用的凭据助手指定了认证方案(即,通过 authtype 字段),则使用该值;如果提供了用户名和密码但没有方案,则使用基本认证。选项的值决定了从助手请求的方案。可能的值有:

  • basic - 向助手请求基本认证。

  • auto - 允许助手选择合适的方案。

  • none - 禁用主动认证。

请注意,此配置应始终与 TLS 一起使用,否则,如果选择了基本认证,很容易意外暴露明文凭据。

http.delegation

控制 GSSAPI 凭据委派。自 libcurl 7.21.7 版本起,默认禁用委派。设置参数以告诉服务器在用户凭据方面允许委派什么。与 GSS/Kerberos 一起使用。可能的值有:

  • none - 不允许任何委派。

  • policy - 仅当 Kerberos 服务票据中设置了 OK-AS-DELEGATE 标志时才委派,这取决于领域策略。

  • always - 无条件允许服务器委派。

http.extraHeader

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

http.cookieFile

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

http.saveCookies

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

http.version

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

  • HTTP/2

  • HTTP/1.1

http.curloptResolve

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

  • [+]HOST:PORT:ADDRESS[,ADDRESS]

  • -HOST:PORT

第一种格式将所有请求重定向到给定的 HOST:PORT 到提供的 ADDRESS(s)。第二种格式清除该 HOST:PORT 组合的所有先前配置值。为了方便覆盖从系统配置继承的所有设置,空值将把所有解析信息重置为空列表。

http.sslVersion

在协商 SSL 连接时要使用的 SSL 版本,如果您想强制使用默认值。可用版本和默认版本取决于 libcurl 是基于 NSS 还是 OpenSSL 构建,以及所用加密库的特定配置。内部设置了 CURLOPT_SSL_VERSION 选项;有关此选项的格式和支持的 SSL 版本的更多详细信息,请参阅 libcurl 文档。目前此选项的可能值有:

  • sslv2

  • sslv3

  • tlsv1

  • tlsv1.0

  • tlsv1.1

  • tlsv1.2

  • tlsv1.3

可以通过 GIT_SSL_VERSION 环境变量覆盖。要强制 Git 使用 libcurl 的默认 SSL 版本并忽略任何显式的 http.sslversion 选项,请将 GIT_SSL_VERSION 设置为空字符串。

http.sslCipherList

协商 SSL 连接时要使用的 SSL 密码列表。可用密码取决于 libcurl 是基于 NSS 还是 OpenSSL 构建,以及所用加密库的特定配置。内部设置了 CURLOPT_SSL_CIPHER_LIST 选项;有关此列表格式的更多详细信息,请参阅 libcurl 文档。

可以通过 GIT_SSL_CIPHER_LIST 环境变量覆盖。要强制 Git 使用 libcurl 的默认密码列表并忽略任何显式的 http.sslCipherList 选项,请将 GIT_SSL_CIPHER_LIST 设置为空字符串。

http.sslVerify

在使用 HTTPS 进行 fetch 或 push 时是否验证 SSL 证书。默认为 true。可以通过 GIT_SSL_NO_VERIFY 环境变量覆盖。

http.sslCert

在使用 HTTPS 进行 fetch 或 push 时包含 SSL 证书的文件。可以通过 GIT_SSL_CERT 环境变量覆盖。

http.sslKey

在使用 HTTPS 进行 fetch 或 push 时包含 SSL 私钥的文件。可以通过 GIT_SSL_KEY 环境变量覆盖。

http.sslCertPasswordProtected

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

http.sslCAInfo

在使用 HTTPS 进行 fetch 或 push 时,包含用于验证对等方的证书文件。可以通过 GIT_SSL_CAINFO 环境变量覆盖。

http.sslCAPath

包含 CA 证书文件的路径,在使用 HTTPS 进行 fetch 或 push 时,这些证书用于验证对等方。可以通过 GIT_SSL_CAPATH 环境变量覆盖。

http.sslBackend

要使用的 SSL 后端名称(例如“openssl”或“schannel”)。如果 cURL 缺少在运行时选择 SSL 后端的功能,则此选项将被忽略。

http.sslCertType

在使用 HTTPS 进行 fetch 或 push 时使用的客户端证书类型。使用 openssl 或 gnutls 后端时支持“PEM”、“DER”。“P12”在“openssl”、“schannel”、“securetransport”和 gnutls 8.11+ 上受支持。另请参阅 libcurl CURLOPT_SSLCERTTYPE。可以通过 GIT_SSL_CERT_TYPE 环境变量覆盖。

http.sslKeyType

在使用 HTTPS 进行 fetch 或 push 时使用的客户端私钥类型。(例如“PEM”、“DER”或“ENG”)。仅在使用“openssl”后端时适用。“DER”不与 openssl 一起支持。当设置为“ENG”以通过 PKCS#11 令牌进行认证时特别有用,`sslCert` 选项中包含 PKCS#11 URL。另请参阅 libcurl CURLOPT_SSLKEYTYPE。可以通过 GIT_SSL_KEY_TYPE 环境变量覆盖。

http.schannelCheckRevoke

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

http.schannelUseSSLCAInfo

自 cURL v7.60.0 起,Secure Channel 后端可以使用通过 http.sslCAInfo 提供的证书包,但这会覆盖 Windows 证书存储。由于默认情况下不希望这样做,Git 将告诉 cURL 在通过 http.sslBackend 配置 schannel 后端时,默认不使用该证书包,除非 http.schannelUseSSLCAInfo 覆盖此行为。

http.pinnedPubkey

HTTPS 服务的公钥。它可以是 PEM 或 DER 编码的公钥文件名,也可以是 sha256// 开头后跟公钥的 base64 编码 sha256 散列的字符串。另请参阅 libcurl CURLOPT_PINNEDPUBLICKEY。如果设置了此选项但 cURL 不支持,Git 将会报错退出。

http.sslTry

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

http.maxRequests

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

http.minSessions

在请求之间要保留的 curl 会话数(跨槽计数)。它们不会在调用 `http_cleanup()` 之前通过 `curl_easy_cleanup()` 结束。如果未定义 `USE_CURL_MULTI`,此值将被限制为 1。默认为 1。

http.postBuffer

智能 HTTP 传输向远程系统 POST 数据时使用的缓冲区最大字节数。对于大于此缓冲区大小的请求,将使用 HTTP/1.1 和 `Transfer-Encoding: chunked` 来避免在本地创建大型 pack 文件。默认值为 1 MiB,这对于大多数请求来说已经足够。

请注意,提高此限制仅对禁用分块传输编码有效,因此仅应在远程服务器或代理仅支持 HTTP/1.0 或不符合 HTTP 标准的情况下使用。一般来说,提高此限制对于大多数推送问题并不是有效的解决方案,但可能会显著增加内存消耗,因为即使是小规模推送也会分配整个缓冲区。

http.lowSpeedLimit
http.lowSpeedTime

如果 HTTP 传输速度(字节/秒)低于 http.lowSpeedLimit 且持续时间超过 http.lowSpeedTime 秒,则传输将被中止。可被 GIT_HTTP_LOW_SPEED_LIMITGIT_HTTP_LOW_SPEED_TIME 环境变量覆盖。

http.keepAliveIdle

指定在发送 TCP 保活探测(如果操作系统支持)之前,空闲连接上等待的秒数。如果未设置,则使用 curl 的默认值。可被 GIT_HTTP_KEEPALIVE_IDLE 环境变量覆盖。

http.keepAliveInterval

指定在 TCP 保活探测之间等待的秒数(如果操作系统支持)。如果未设置,则使用 curl 的默认值。可被 GIT_HTTP_KEEPALIVE_INTERVAL 环境变量覆盖。

http.keepAliveCount

指定在放弃并终止连接之前发送的 TCP 保活探测次数(如果操作系统支持)。如果未设置,则使用 curl 的默认值。可被 GIT_HTTP_KEEPALIVE_COUNT 环境变量覆盖。

http.noEPSV

一个布尔值,用于禁用 curl 使用 EPSV FTP 命令。这对于一些“简陋的”FTP 服务器很有帮助,因为它们不支持 EPSV 模式。可被 GIT_CURL_FTP_NO_EPSV 环境变量覆盖。默认为 false(curl 将使用 EPSV)。

http.userAgent

向 HTTP 服务器呈现的 HTTP USER_AGENT 字符串。默认值表示 Git 客户端的版本,例如 git/1.7.1。此选项允许您将此值覆盖为更常见的值,例如 Mozilla/4.0。例如,如果通过限制 HTTP 连接到一组常见 USER_AGENT 字符串(但不包括 git/1.7.1 等)的防火墙进行连接,这可能是必要的。可被 GIT_HTTP_USER_AGENT 环境变量覆盖。

http.followRedirects

Git 是否应遵循 HTTP 重定向。如果设置为 true,Git 将透明地遵循其遇到的服务器发出的任何重定向。如果设置为 false,Git 会将所有重定向视为错误。如果设置为 initial,Git 只会遵循对远程仓库的初始请求的重定向,而不遵循后续的 HTTP 请求。由于 Git 使用重定向的 URL 作为后续请求的基础,这通常就足够了。默认值为 initial

http.<url>.*

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

  1. 方案(例如,https://example.com/ 中的 https)。此字段必须在配置键和 URL 之间精确匹配。

  2. 主机/域名(例如,https://example.com/ 中的 example.com)。此字段必须在配置键和 URL 之间匹配。可以在主机名中指定 * 以匹配此级别下的所有子域名。例如,https://*.example.com/ 将匹配 https://foo.example.com/,但不匹配 https://foo.bar.example.com/

  3. 端口号(例如,http://example.com:8080/ 中的 8080)。此字段必须在配置键和 URL 之间精确匹配。省略的端口号在匹配前会自动转换为该方案的正确默认值。

  4. 路径(例如,https://example.com/repo.git 中的 repo.git)。配置键的路径字段必须与 URL 的路径字段精确匹配,或者作为斜杠分隔路径元素的前缀匹配。这意味着路径为 foo/ 的配置键匹配 URL 路径 foo/bar。前缀只能在斜杠(/)边界处匹配。较长的匹配优先(因此,路径为 foo/bar 的配置键比仅路径为 foo/ 的配置键更能匹配 URL 路径 foo/bar)。

  5. 用户名(例如,https://user@example.com/repo.git 中的 user)。如果配置键包含用户名,它必须与 URL 中的用户名精确匹配。如果配置键没有用户名,则该配置键将匹配任何用户名的 URL(包括没有用户名的),但优先级低于包含用户名的配置键。

上述列表按优先级递减排序;匹配配置键路径的 URL 优先于匹配其用户名的 URL。例如,如果 URL 是 https://user@example.com/foo/bar,则配置键 https://example.com/foo 的匹配将优先于配置键 https://user@example.com 的匹配。

所有 URL 在尝试匹配之前都会进行标准化处理(密码部分,如果嵌入在 URL 中,在匹配时始终被忽略),以便拼写不同但等效的 URL 也能正确匹配。环境变量设置始终覆盖任何匹配项。用于匹配的 URL 是直接提供给 Git 命令的 URL。这意味着因重定向而访问的任何 URL 不参与匹配。

i18n.commitEncoding

提交消息的字符编码;Git 本身并不关心,但此信息在从电子邮件导入提交或在 gitk 图形历史浏览器中(以及未来可能在其他地方或在其他瓷器中)是必需的。参见 git-mailinfo[1]。默认为 utf-8

i18n.logOutputEncoding

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

imap.folder

放置邮件的文件夹,通常是草稿文件夹。例如:“INBOX.Drafts”、“INBOX/Drafts”或“[Gmail]/Drafts”。必需。

imap.tunnel

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

imap.host

标识服务器的 URL。非安全连接使用 imap:// 前缀,安全连接使用 imaps:// 前缀。设置了 imap.tunnel 时忽略,否则必需。

imap.user

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

imap.pass

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

imap.port

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

imap.sslverify

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

imap.preformattedHTML

一个布尔值,用于启用/禁用发送补丁时使用 HTML 编码。HTML 编码的补丁将用 <pre> 括起来,并具有 text/html 的内容类型。讽刺的是,启用此选项会导致 Thunderbird 将补丁作为纯文本、固定格式的电子邮件发送。默认为 false

imap.authMethod

指定与 IMAP 服务器进行认证的认证方法。如果 Git 是用 NO_CURL 选项构建的,或者您的 curl 版本低于 7.34.0,或者您正在使用 --no-curl 选项运行 git-imap-send,则唯一支持的方法是 CRAM-MD5。如果未设置此项,则 git imap-send 将使用基本的 IMAP 明文 LOGIN 命令。

include.path
includeIf.<condition>.path

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

index.recordEndOfIndexEntries

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

index.recordOffsetTable

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

index.sparse

启用后,使用稀疏目录条目写入索引。除非 core.sparseCheckoutcore.sparseCheckoutCone 都已启用,否则这没有效果。默认为 false

index.threads

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

index.version

指定新索引文件应初始化的版本。这不影响现有仓库。如果 feature.manyFiles 已启用,则默认值为 4。

index.skipHash

启用后,不计算索引文件的尾随哈希。这会加速操作索引的 Git 命令,例如 git addgit commitgit status。不存储校验和,而是写入一组值为零的尾随字节,表示已跳过计算。

如果启用 index.skipHash,则 2.13.0 之前的 Git 客户端将拒绝解析索引,而 2.40.0 之前的 Git 客户端将在 git fsck 期间报告错误。

init.templateDir

指定要复制模板的目录。(参见 git-init[1] 的“模板目录”部分。)

init.defaultBranch

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

init.defaultObjectFormat

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

init.defaultRefFormat

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

instaweb.browser

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

instaweb.httpd

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

instaweb.local

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

instaweb.modulePath

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

instaweb.port

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

interactive.singleKey

当设置为 true 时,允许用户在交互式命令中通过单个按键(即无需按回车键)提供单字母输入。目前,这用于 git-add[1]git-checkout[1]git-restore[1]git-commit[1]git-reset[1]git-stash[1]--patch 模式。

interactive.diffFilter

当交互式命令(例如 git add --patch)显示彩色差异时,git 会将差异通过此配置变量定义的 shell 命令管道传输。该命令可能会进一步标记差异以供人类阅读,但前提是它与原始差异中的行保持一一对应。默认为禁用(无过滤)。

log.abbrevCommit

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

log.date

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

如果格式设置为 "auto:foo" 且正在使用寻呼机,则日期格式将使用 "foo" 格式。否则,将使用 "default"。

log.decorate

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

log.initialDecorationSet

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

log.excludeDecoration

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

log.diffMerges

设置指定 --diff-merges=on 时使用的差异格式,详情请参见 git-log[1] 中的 --diff-merges。默认为 separate

log.follow

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

log.graphColors

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

log.showRoot

如果为 true,则初始提交将显示为一个大型创建事件。这相当于与空树的差异。通常隐藏根提交的工具(如 git-log[1]git-whatchanged[1])现在将显示它。默认为 True。

log.showSignature

如果为 true,则使 git-log[1]git-show[1]git-whatchanged[1] 假设使用 --show-signature

log.mailmap

如果为 true,则使 git-log[1]git-show[1]git-whatchanged[1] 假设使用 --use-mailmap,否则假设使用 --no-use-mailmap。默认为 true。

lsrefs.unborn

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

mailinfo.scissors

如果为 true,则使 git-mailinfo[1](以及因此 git-am[1])默认行为如同在命令行上提供了 --scissors 选项。当激活时,此功能会移除剪刀线(即主要由“>8”、“8<”和“-”组成)之前消息正文中的所有内容。

mailmap.file

增强型 mailmap 文件的位置。位于仓库根目录的默认 mailmap 首先加载,然后是此变量指向的 mailmap 文件。mailmap 文件的位置可以在仓库子目录中,也可以在仓库本身之外。参见 git-shortlog[1]git-blame[1]

mailmap.blob

mailmap.file 类似,但将该值视为仓库中 blob 的引用。如果同时给定了 mailmap.filemailmap.blob,两者都会被解析,其中 mailmap.file 中的条目优先。在裸仓库中,此项默认为 HEAD:.mailmap。在非裸仓库中,此项默认为空。

maintenance.auto

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

maintenance.autoDetach

许多 Git 命令在将数据写入仓库后会触发自动维护。此布尔配置选项控制这种自动维护是在前台进行,还是维护过程应分离并在后台继续运行。

如果未设置,则使用 gc.autoDetach 的值作为回退。如果两者都未设置,则默认为 true,这意味着维护过程将分离。

maintenance.strategy

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

  • none:此默认设置意味着在任何计划下都不运行任何任务。

  • incremental:此设置优化执行不删除任何数据的小型维护活动。这不安排 gc 任务,但每小时运行 prefetchcommit-graph 任务,每天运行 loose-objectsincremental-repack 任务,每周运行 pack-refs 任务。

maintenance.<task>.enabled

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

maintenance.<task>.schedule

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

maintenance.commit-graph.auto

此整数配置选项控制 commit-graph 任务作为 git maintenance run --auto 的一部分应该多久运行一次。如果为零,则 commit-graph 任务将不会与 --auto 选项一起运行。负值将强制任务每次都运行。否则,正值意味着当不在提交图文件中的可达提交数量至少为 maintenance.commit-graph.auto 的值时,命令应该运行。默认值为 100。

maintenance.loose-objects.auto

此整数配置选项控制 loose-objects 任务作为 git maintenance run --auto 的一部分应该多久运行一次。如果为零,则 loose-objects 任务将不会与 --auto 选项一起运行。负值将强制任务每次都运行。否则,正值意味着当松散对象的数量至少为 maintenance.loose-objects.auto 的值时,命令应该运行。默认值为 100。

maintenance.loose-objects.batchSize

此整数配置选项控制在 loose-objects 任务期间写入包文件中的松散对象的最大数量。默认值为五万。使用值 0 表示没有限制。

maintenance.incremental-repack.auto

此整数配置选项控制 incremental-repack 任务作为 git maintenance run --auto 的一部分应该多久运行一次。如果为零,则 incremental-repack 任务将不会与 --auto 选项一起运行。负值将强制任务每次都运行。否则,正值意味着当不在多包索引中的包文件数量至少为 maintenance.incremental-repack.auto 的值时,命令应该运行。默认值为 10。

maintenance.reflog-expire.auto

此整数配置选项控制 reflog-expire 任务作为 git maintenance run --auto 的一部分应该多久运行一次。如果为零,则 reflog-expire 任务将不会与 --auto 选项一起运行。负值将强制任务每次都运行。否则,正值意味着当“HEAD”reflog 中过期 reflog 条目的数量至少为 maintenance.loose-objects.auto 的值时,命令应该运行。默认值为 100。

maintenance.rerere-gc.auto

此整数配置选项控制 rerere-gc 任务作为 git maintenance run --auto 的一部分应该多久运行一次。如果为零,则 rerere-gc 任务将不会与 --auto 选项一起运行。负值将强制任务每次都运行。否则,任何正值都意味着当“rr-cache”目录存在并且至少有一个条目时,命令就会运行,无论它是否陈旧。这种启发式方法未来可能会完善。默认值为 1。

maintenance.worktree-prune.auto

此整数配置选项控制 worktree-prune 任务作为 git maintenance run --auto 的一部分应该多久运行一次。如果为零,则 worktree-prune 任务将不会与 --auto 选项一起运行。负值将强制任务每次都运行。否则,正值意味着当可清理的工作树数量超过该值时,命令应该运行。默认值为 1。

man.viewer

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

man.<tool>.cmd

指定调用指定 man 浏览器的命令。指定的命令在 shell 中执行,并将 man 页面作为参数传递。(参见 git-help[1]。)

man.<tool>.path

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

merge.conflictStyle

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

merge.defaultToUpstream

如果调用 `merge` 时未带任何提交参数,则通过使用当前分支的远程跟踪分支中存储的最新观察值,合并为当前分支配置的上游分支。系统会查阅由 branch.<current-branch>.remote 指定的远程仓库中,由 branch.<current branch>.merge 命名的分支的值,然后通过 remote.<remote>.fetch 将它们映射到相应的远程跟踪分支,并合并这些跟踪分支的尖端。默认为 true。

merge.ff

默认情况下,当合并一个作为当前提交后代的提交时,Git 不会创建额外的合并提交。相反,当前分支的尖端会进行快进。当设置为 false 时,此变量会指示 Git 在这种情况下创建额外的合并提交(等同于从命令行提供 --no-ff 选项)。当设置为 only 时,只允许此类快进合并(等同于从命令行提供 --ff-only 选项)。

merge.verifySignatures

如果为 true,这等同于命令行选项 --verify-signatures。详情请参阅 git-merge[1]

merge.branchdesc

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

merge.log

除了分支名称之外,还会用最多指定数量的实际合并提交的单行描述填充日志消息。默认为 false,true 是 20 的同义词。

merge.suppressDest

通过将匹配集成(integration)分支名称的 glob 添加到此多值配置变量中,计算出的合并到这些集成分支的默认合并消息将省略标题中的“into <branch-name>”。

一个空值的元素可用于清除从以前配置条目累积的 glob 列表。当没有定义 merge.suppressDest 变量时,为了向后兼容,会使用默认值 master

merge.renameLimit

在合并过程中进行详尽的重命名检测时要考虑的文件数量。如果未指定,则默认为 diff.renameLimit 的值。如果既未指定 merge.renameLimit 也未指定 diff.renameLimit,则当前默认为 7000。如果重命名检测已关闭,此设置无效。

merge.renames

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

merge.directoryRenames

Git 是否检测目录重命名,这会影响在历史记录的一侧,当目录被重命名后,另一侧添加到该目录的新文件在合并时如何处理。可能的值为:

false

禁用目录重命名检测,这意味着此类新文件将保留在旧目录中。

true

启用目录重命名检测,这意味着此类新文件将移动到新目录中。

conflict

将为此类路径报告冲突。

如果 merge.renamesfalse,则 merge.directoryRenames 将被忽略并被视为 false。默认为 conflict

merge.renormalize

告诉 Git 仓库中文件的规范表示随时间发生了变化(例如,早期的提交记录文本文件使用 CRLF 行尾,但最近的提交使用 LF 行尾)。在此类仓库中,对于每个需要三向内容合并的文件,Git 可以在执行合并之前将提交中记录的数据转换为规范形式,以减少不必要的冲突。有关更多信息,请参阅 gitattributes[5] 中“使用不同签入/签出属性合并分支”一节。

merge.stat

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

merge.autoStash

当设置为 true 时,在操作开始前自动创建一个临时暂存条目,并在操作结束后应用它。这意味着你可以在一个有改动的(dirty)工作树上运行合并。然而,请谨慎使用:成功合并后的最终暂存应用可能会导致不小的冲突。此选项可以通过 git-merge[1]--no-autostash--autostash 选项覆盖。默认为 false

merge.tool

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

merge.guitool

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

  • araxis

  • bc

  • codecompare

  • deltawalker

  • diffmerge

  • diffuse

  • ecmerge

  • emerge

  • examdiff

  • guiffy

  • gvimdiff

  • kdiff3

  • meld

  • nvimdiff

  • opendiff

  • p4merge

  • smerge

  • tkdiff

  • tortoisemerge

  • vimdiff

  • vscode

  • winmerge

  • xxdiff

merge.verbosity

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

merge.<driver>.name

为自定义的低级合并驱动程序定义一个人类可读的名称。详情请参阅 gitattributes[5]

merge.<driver>.driver

定义实现自定义低级合并驱动程序的命令。详情请参阅 gitattributes[5]

merge.<driver>.recursive

指定在共同祖先之间执行内部合并时要使用的低级合并驱动程序。详情请参阅 gitattributes[5]

mergetool.<tool>.path

覆盖给定工具的路径。当你的工具不在 $PATH 中时,这很有用。

mergetool.<tool>.cmd

指定调用指定合并工具的命令。指定的命令将在 shell 中评估,并提供以下变量:BASE 是包含待合并文件的共同基础的临时文件名称(如果可用);LOCAL 是包含当前分支上文件内容的临时文件名称;REMOTE 是包含来自被合并分支文件内容的临时文件名称;MERGED 包含合并工具应写入成功合并结果的文件名称。

mergetool.<tool>.hideResolved

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

mergetool.<tool>.trustExitCode

对于自定义合并命令,指定是否可以使用合并命令的退出代码来判断合并是否成功。如果此选项未设置为 true,则会检查合并目标文件的时间戳,如果文件已更新,则假定合并成功;否则,系统会提示用户指示合并是否成功。

mergetool.meld.hasOutput

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

mergetool.meld.useAutoMerge

当给定 --auto-merge 时,meld 将自动合并所有无冲突部分,突出显示冲突部分,并等待用户决定。将 mergetool.meld.useAutoMerge 设置为 true 会告诉 Git 无条件地将 --auto-merge 选项与 meld 一起使用。将此值设置为 auto 会使 Git 检测是否支持 --auto-merge,并且仅在可用时才使用 --auto-merge。值为 false 则完全避免使用 --auto-merge,这也是默认值。

mergetool.<variant>.layout

配置 vimdiff 的 <variant> 的分窗布局,其中 <variant> 可以是 vimdiffnvimdiffgvimdiff 中的任意一个。当使用 --tool=<variant>(或如果 merge.tool 配置为 <variant> 则不带 --tool)启动 git mergetool 时,Git 将查阅 mergetool.<variant>.layout 以确定工具的布局。如果特定变体的配置不可用,则使用 vimdiff 的作为备用。如果该备用也不可用,则将使用包含 4 个窗口的默认布局。要配置布局,请参阅 git-mergetool[1] 中的 BACKEND SPECIFIC HINTS(后端特定提示)部分。

mergetool.hideResolved

在合并过程中,Git 会自动解决尽可能多的冲突,并写入包含冲突标记的 $MERGED 文件,标记那些它无法解决的冲突;$LOCAL$REMOTE 通常是 Git 解决冲突前的文件版本。此标志会导致 $LOCAL$REMOTE 被覆盖,以便只将未解决的冲突呈现给合并工具。可以通过 mergetool.<tool>.hideResolved 配置变量按工具进行配置。默认为 false

mergetool.keepBackup

执行合并后,带有冲突标记的原始文件可以保存为带有 .orig 扩展名的文件。如果此变量设置为 false,则此文件不会保留。默认为 true(即保留备份文件)。

mergetool.keepTemporaries

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

mergetool.writeToTemp

默认情况下,Git 会将冲突文件的临时 BASELOCALREMOTE 版本写入工作树。当设置为 true 时,Git 将尝试为这些文件使用一个临时目录。默认为 false

mergetool.prompt

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

mergetool.guiDefault

设置为 true 以默认使用 merge.guitool(等同于指定 --gui 参数),或者设置为 auto 以根据是否存在 DISPLAY 环境变量值来选择 merge.guitoolmerge.tool。默认值为 false,此时必须显式提供 --gui 参数才能使用 merge.guitool

notes.mergeStrategy

解决注解(notes)冲突时默认选择哪种合并策略。必须是 manualourstheirsunioncat_sort_uniq 之一。默认为 manual。有关每种策略的更多信息,请参阅 git-notes[1] 的“NOTES MERGE STRATEGIES”(注解合并策略)一节。

此设置可以通过向 git-notes[1] 传递 --strategy 选项来覆盖。

notes.<name>.mergeStrategy

将注解合并到 refs/notes/<name> 时选择哪种合并策略。这会覆盖更通用的 notes.mergeStrategy。有关可用策略的更多信息,请参阅 git-notes[1] 的“NOTES MERGE STRATEGIES”(注解合并策略)一节。

notes.displayRef

在使用 git log 系列命令显示提交消息时,除了由 core.notesRefGIT_NOTES_REF 设置的默认值外,从哪个引用(或多个引用,如果使用了 glob 或指定了多次)读取注解。

此设置可以通过 GIT_NOTES_DISPLAY_REF 环境变量覆盖,该变量必须是一个以冒号分隔的引用或 glob 列表。

对于不存在的引用将发出警告,但与任何引用不匹配的 glob 将被静默忽略。

此设置可以通过 git-log[1] 系列命令的 --no-notes 选项,或这些命令接受的 --notes=<ref> 选项禁用。

core.notesRef 的有效值(可能被 GIT_NOTES_REF 覆盖)也会隐式添加到要显示的引用列表中。

notes.rewrite.<command>

当使用 <command>(目前是 amendrebase)重写提交时,如果此变量为 false,则 Git 不会将注解从原始提交复制到重写后的提交。默认为 true。另请参阅下面的 notes.rewriteRef

此设置可以通过 GIT_NOTES_REWRITE_REF 环境变量覆盖,该变量必须是一个以冒号分隔的引用或 glob 列表。

notes.rewriteMode

在重写期间复制注解时(参见 notes.rewrite.<command> 选项),确定如果目标提交已有注解该如何处理。必须是 overwrite(覆盖)、concatenate(连接)、cat_sort_uniqignore(忽略)之一。默认为 concatenate

此设置可以通过 GIT_NOTES_REWRITE_MODE 环境变量覆盖。

notes.rewriteRef

在重写期间复制备注时,指定(完全限定的)要复制备注的引用。可以是一个 glob,在这种情况下,所有匹配引用中的备注都将被复制。您也可以多次指定此配置。

没有默认值;您必须配置此变量才能启用备注重写。将其设置为 refs/notes/commits 以启用默认提交备注的重写。

可以通过 GIT_NOTES_REWRITE_REF 环境变量覆盖。有关其格式的进一步描述,请参见上面的 notes.rewrite.<command>

pack.window

当命令行未指定窗口大小时,git-pack-objects[1] 使用的窗口大小。默认为 10。

pack.depth

当命令行未指定最大深度时,git-pack-objects[1] 使用的最大增量深度。默认为 50。最大值为 4095。

pack.windowMemory

当命令行未指定限制时,git-pack-objects[1] 中每个线程用于包窗口内存的最大内存消耗量。该值可以后缀“k”、“m”或“g”。如果未配置(或显式设置为 0),则没有限制。

pack.compression

一个整数,范围为 -1..9,表示包文件中对象的压缩级别。-1 是 zlib 默认值。0 表示不压缩,1..9 是各种速度/大小的权衡,9 最慢。如果未设置,则默认为 core.compression。如果 core.compression 也未设置,则默认为 -1,即 zlib 默认值,这是“速度和压缩之间的默认折衷(当前等效于级别 6)”。

请注意,更改压缩级别不会自动重新压缩所有现有对象。你可以通过向 git-repack[1] 传递 -F 选项来强制重新压缩。

pack.allowPackReuse

当为 true 或 "single" 且启用可达性位图时,pack-objects 将尝试按原样发送位图包文件的部分内容。当为 "multi" 且多包可达性位图可用时,pack-objects 将尝试发送 MIDX 中所有包的部分内容。

如果只有一个包位图可用,并且 pack.allowPackReuse 设置为 "multi",则仅重用位图包文件的部分内容。这可以减少服务 fetch 时的内存和 CPU 使用量,但可能会导致发送略大的包。默认为 true。

pack.island

一个扩展的正则表达式,用于配置一组增量岛。详情请参阅 git-pack-objects[1] 中的“DELTA ISLANDS”(增量岛)部分。

pack.islandCore

指定一个岛屿名称,其对象将首先被打包。这会在一个包的前面创建一种伪包,以便指定岛屿中的对象能更快地复制到应提供给请求这些对象的用户的任何包中。实际上,这意味着指定的岛屿可能对应于仓库中最常被克隆的内容。另请参阅 git-pack-objects[1] 中的“DELTA ISLANDS”(增量岛)部分。

pack.deltaCacheSize

在将增量写入包之前,git-pack-objects[1] 中用于缓存增量的最大内存量(以字节为单位)。此缓存用于加速写入对象阶段,因为它在找到所有对象的最佳匹配后无需重新计算最终增量结果。然而,在内存紧张的机器上重新打包大型仓库可能会因此受到严重影响,尤其是当此缓存导致系统开始交换时。值为 0 表示没有限制。最小的 1 字节大小可用于实际禁用此缓存。默认为 256 MiB。

pack.deltaCacheLimit

git-pack-objects[1] 中缓存的增量最大大小。此缓存用于加速写入对象阶段,因为它在找到所有对象的最佳匹配后无需重新计算最终增量结果。默认为 1000。最大值为 65535。

pack.threads

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

pack.indexVersion

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

如果你有一个旧版 Git 无法识别版本 2 的 *.idx 文件,通过非原生协议(例如“http”)克隆或抓取时,如果同时复制了对方的 *.pack 文件和相应的 *.idx 文件,你可能会得到一个你的旧版 Git 无法访问的仓库。然而,如果 *.pack 文件小于 2 GB,你可以对 *.pack 文件使用 git-index-pack[1] 来重新生成 *.idx 文件。

pack.packSizeLimit

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

请注意,此选项很少有用,并且可能导致磁盘总大小更大(因为 Git 不会在包之间存储增量),以及更差的运行时性能(在多个包中查找对象比在单个包中慢,并且像可达性位图这样的优化无法处理多个包)。

如果你需要使用较小的包文件来主动运行 Git(例如,因为你的文件系统不支持大文件),此选项可能会有所帮助。但如果你的目标是通过支持有限大小的介质(例如,无法存储整个仓库的可移动介质)传输包文件,你最好创建一个单独的大包文件,然后使用通用的多卷归档工具(例如 Unix split)将其分割。

允许的最小大小限制为 1 MiB。默认无限制。支持常见的单位后缀 kmg

pack.useBitmaps

当为 true 时,Git 在打包到标准输出时(例如,在 fetch 的服务器端)将使用包位图(如果可用)。默认为 true。除非你在调试包位图,否则通常不需要关闭此功能。

pack.useBitmapBoundaryTraversal

当为 true 时,Git 将使用一种实验性算法,通过位图计算可达性查询。它不是为所有被否定(negated)的尖端构建完整的位图然后将它们 OR 起来,而是将具有现有位图的被否定尖端视为加性的(即,如果它们存在,则将其 OR 到结果中,否则忽略它们),而是在边界处构建位图。

使用此算法时,Git 可能会由于未打开属于某些“不重要”(UNINTERESTING)提交的树而包含过多对象。这种不精确性与非位图遍历算法相符。

在许多情况下,这可以比精确算法提供更快的速度,特别是在查询的否定侧位图覆盖率较差时。

pack.useSparse

当为 true 时,如果存在 --revs 选项,Git 将默认在 git pack-objects 中使用 --sparse 选项。此算法仅遍历引入新对象的路径中出现的树。在计算要发送小改动的包时,这可以显著提高性能。然而,如果包含的提交包含某些类型的直接重命名,则可能会向包文件添加额外的对象。默认值为 true

pack.preferBitmapTips

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

请注意,将此配置设置为 refs/foo 并不意味着一定会选择 refs/foo/barrefs/foo/baz 尖端的提交。这是因为位图的提交是从一系列可变长度的窗口中选择的。

如果在窗口中看到任何引用尖端(其是此配置任何值的后缀)上的提交,它将立即获得比该窗口中任何其他提交更高的优先级。

pack.writeBitmaps(已弃用)

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

pack.writeBitmapHashCache

当为 true 时,Git 将在位图索引中(如果写入)包含一个“哈希缓存”部分。此缓存可用于为 Git 的增量启发式算法提供数据,从而可能在位图对象和非位图对象之间产生更好的增量(例如,当在较旧的位图包和自上次 gc 以来已推送的对象之间提供 fetch 服务时)。缺点是它会占用每个对象 4 字节的磁盘空间。默认为 true。

在写入多包可达性位图时,不会计算新的名称哈希;相反,写入新位图时,现有位图中存储的任何名称哈希都会排列到其适当的位置。

pack.writeBitmapLookupTable

当为 true 时,Git 将在位图索引中(如果写入)包含一个“查找表”部分。此表用于尽可能延迟加载单个位图。这对于具有相对较大位图索引的仓库可能很有利。默认为 false。

pack.readReverseIndex

当为 true 时,Git 将读取任何可能可用的 .rev 文件(参见:gitformat-pack[5])。当为 false 时,反向索引将从头开始生成并存储在内存中。默认为 true。

pack.writeReverseIndex

当为 true 时,Git 将为其写入的每个新包文件(除了 git-fast-import[1] 和批量签入机制之外的所有位置)写入相应的 .rev 文件(参见:gitformat-pack[5])。默认为 true。

pager.<cmd>

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

pretty.<name>

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

promisor.quiet

如果设置为“true”,则在为部分克隆获取额外对象时假定为 --quiet

promisor.advertise

如果设置为“true”,则服务器将使用“promisor-remote”能力(参见 gitprotocol-v2[5])来宣告其正在使用的 promisor 远程仓库(如果它使用了)。默认值为“false”,这意味着不宣告“promisor-remote”能力。

promisor.acceptFromServer

如果设置为“all”,则客户端将接受服务器可能使用“promisor-remote”能力宣告的所有 promisor 远程仓库。如果设置为“knownName”,客户端将接受已在客户端配置且与客户端宣告的 promisor 远程仓库同名的 promisor 远程仓库。这不是很安全,但可以在服务器和客户端被信任不会更改名称和 URL 的公司设置中使用。如果设置为“knownUrl”,客户端将接受在客户端配置的名称和 URL 与服务器宣告的名称和 URL 相同的 promisor 远程仓库。这比“all”或“knownName”更安全,因此如果可能,应使用此选项而不是其他选项。默认值为“none”,这意味着不接受服务器宣告的任何 promisor 远程仓库。通过接受 promisor 远程仓库,客户端同意服务器可能会在其对客户端“fetch”和“clone”请求的响应中,省略那些可从该 promisor 远程仓库延迟获取的对象。名称和 URL 比较区分大小写。参见 gitprotocol-v2[5]

protocol.allow

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

  • always - 协议始终可以使用。

  • never - 协议从不可以使用。

  • user - 仅当 GIT_PROTOCOL_FROM_USER 未设置或值为 1 时,协议才可以使用。当您希望协议可供用户直接使用,但又不希望它被在没有用户输入的情况下执行 clone/fetch/push 命令(例如递归子模块初始化)的命令使用时,应采用此策略。

protocol.<name>.allow

设置协议 <name> 在 clone/fetch/push 命令中使用的策略。有关可用策略,请参阅上面的 protocol.allow

Git 当前使用的协议名称有:

  • file: 任何基于本地文件的路径(包括 file:// URL 或本地路径)

  • git: 通过直接 TCP 连接(或代理,如果已配置)的匿名 Git 协议

  • ssh: 通过 SSH 的 Git(包括 host:path 语法、ssh:// 等)。

  • http: 通过 HTTP 的 Git,包括“智能 HTTP”和“哑 HTTP”。请注意,这不包括 https;如果您想同时配置两者,则必须单独进行。

  • 任何外部帮助器都以其协议命名(例如,使用 hg 允许 git-remote-hg 帮助器)

protocol.version

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

  • 0 - 原始线路协议。

  • 1 - 原始线路协议,并在服务器的初始响应中增加了版本字符串。

  • 2 - 线路协议版本 2,参见 gitprotocol-v2[5]

pull.ff

默认情况下,当合并一个作为当前提交后代的提交时,Git 不会创建额外的合并提交。相反,当前分支的末端会被快进。当设置为 false 时,此变量会告诉 Git 在这种情况下创建额外的合并提交(相当于从命令行提供 --no-ff 选项)。当设置为 only 时,只允许此类快进合并(相当于从命令行提供 --ff-only 选项)。此设置在拉取时会覆盖 merge.ff

pull.rebase

当设置为 true 时,在运行“git pull”时,会将分支变基到已拉取分支的顶部,而不是合并来自默认远程的默认分支。有关按分支设置此项,请参阅“branch.<name>.rebase”。

当值为 merges(或简称 m)时,将 --rebase-merges 选项传递给 git rebase,以便本地合并提交包含在变基中(有关详细信息,请参见 git-rebase[1])。

当值为 interactive(或简称 i)时,变基以交互模式运行。

注意:这是一个可能有危险的操作;除非你理解其影响(详情请参阅 git-rebase[1]),否则不要使用它。

pull.octopus

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

pull.twohead

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

push.autoSetupRemote

如果设置为“true”,则在当前分支没有上游跟踪时,默认推送时假定使用 --set-upstream;此选项对 push.default 选项 simpleupstreamcurrent 生效。如果您默认希望将新分支推送到默认远程(类似于 push.default=current 的行为),并且还希望设置上游跟踪,则此选项很有用。最有可能受益于此选项的工作流是*简单*的集中式工作流,其中所有分支都应在远程上具有相同的名称。

push.default

定义了在未指定引用(无论是在命令行、配置文件还是其他地方)时,git push 应采取的操作。不同的值适用于特定的工作流;例如,在纯粹的集中式工作流中(即拉取源与推送目标相同),upstream 可能正是您想要的。可能的值有:

  • nothing - 除非给定引用,否则不推送任何内容(报错)。这主要是为了那些希望通过始终明确指定来避免错误的人。

  • current - 推送当前分支,以更新接收端同名分支。在集中式和非集中式工作流中均适用。

  • upstream - 将当前分支推送回其更改通常集成到当前分支中的分支(即 @{upstream})。此模式仅在您推送到通常从中拉取的同一仓库时才有意义(即集中式工作流)。

  • tracking - 这是 upstream 的已废弃同义词。

  • simple - 将当前分支推送到远程上同名的分支。

    如果您正在使用集中式工作流(推送到您从中拉取的同一仓库,通常是 origin),那么您需要配置一个同名的上游分支。

    此模式自 Git 2.0 起成为默认值,是适合初学者的最安全选项。

  • matching - 推送两端具有相同名称的所有分支。这使得您推送到的仓库会记住将被推送出的分支集(例如,如果您总是将 maintmaster 推送到那里,而没有其他分支,那么您推送到的仓库将拥有这两个分支,并且您的本地 maintmaster 将被推送到那里)。

    要有效使用此模式,您必须确保在运行 git push 之前,所有要推送的分支都已准备好被推送,因为此模式的全部目的就是允许您一次性推送所有分支。如果您通常只在一个分支上完成工作并推送结果,而其他分支尚未完成,则此模式不适合您。此外,此模式不适用于推送到共享的集中式仓库,因为其他人可能会在那里添加新分支,或在您无法控制的情况下更新现有分支的末端。

    这曾是默认值,但自 Git 2.0 以来不再是(simple 是新的默认值)。

push.followTags

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

push.gpgSign

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

push.pushOption

当命令行中未提供 --push-option=<option> 参数时,git push 的行为如同此变量的每个 <value> 都作为 --push-option=<value> 给出一样。

这是一个多值变量,空值可以在高优先级配置文件(例如仓库中的 .git/config)中使用,以清除从低优先级配置文件(例如 $HOME/.gitconfig)继承的值。

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).
push.recurseSubmodules

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

push.useForceIfIncludes

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

push.negotiate

如果设置为“true”,则尝试通过客户端和服务器试图寻找共同提交的多轮协商来减小发送的 packfile 大小。如果为“false”,Git 将仅依靠服务器的引用宣告来寻找共同提交。

push.useBitmaps

如果设置为“false”,则禁用“git push”使用位图,即使 pack.useBitmaps 为“true”也是如此,同时不阻止其他 Git 操作使用位图。默认值为 true。

rebase.backend

变基操作的默认后端。可能的选择是 applymerge。将来,如果 merge 后端获得了 apply 后端所有剩余的功能,此设置可能会变得不再使用。

rebase.stat

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

rebase.autoSquash

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

rebase.autoStash

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

rebase.updateRefs

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

rebase.missingCommitsCheck

如果设置为“warn”,如果某些提交被删除(例如,删除了一行),git rebase -i 将打印警告,但变基仍将继续。如果设置为“error”,它将打印前面的警告并停止变基,此时可以使用 git rebase --edit-todo 来纠正错误。如果设置为“ignore”,则不执行任何检查。要删除提交而不发出警告或错误,请在待办列表中使用 drop 命令。默认值为“ignore”。

rebase.instructionFormat

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

rebase.abbreviateCommands

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

默认值为 false。

rebase.rescheduleFailedExec

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

rebase.forkPoint

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

rebase.rebaseMerges

是否以及如何默认设置 --rebase-merges 选项。可以是 rebase-cousinsno-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 配置。

rebase.maxLabelLength

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

receive.advertiseAtomic

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

receive.advertisePushOptions

当设置为 true 时,git-receive-pack 会向其客户端宣告推送选项能力。默认值为 false。

receive.autogc

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

receive.certNonceSeed

通过将此变量设置为字符串,git receive-pack 将接受 git push --signed,并通过使用一个由 HMAC 保护的“nonce”(此字符串作为密钥)来验证它。

receive.certNonceSlop

git push --signed 发送的推送证书包含一个由服务同一仓库的 receive-pack 在指定秒数内颁发的“nonce”时,将证书中找到的“nonce”导出到钩子脚本的 GIT_PUSH_CERT_NONCE 环境变量中(而不是 receive-pack 要求发送方包含的值)。这可能使在 pre-receivepost-receive 钩子中编写检查变得更容易一些。他们无需检查记录 nonce 过期秒数的 GIT_PUSH_CERT_NONCE_SLOP 环境变量来决定是否接受证书,只需检查 GIT_PUSH_CERT_NONCE_STATUS 是否为 OK

receive.fsckObjects

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

receive.fsck.<msg-id>

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

receive.fsck.skipList

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

receive.keepAlive

从客户端接收到数据包后,receive-pack 在处理数据包时可能不产生任何输出(如果指定了 --quiet),这会导致某些网络断开 TCP 连接。设置此选项后,如果 receive-pack 在此阶段 receive.keepAlive 秒内没有传输任何数据,它将发送一个短的保活数据包。默认值为 5 秒;设置为 0 则完全禁用保活。

receive.unpackLimit

如果一次推送中接收到的对象数量低于此限制,则对象将被解包为松散对象文件。但是,如果接收到的对象数量等于或超过此限制,则接收到的 pack 将作为 pack 存储,并在添加任何缺失的 delta base 之后。存储来自推送的 pack 可以使推送操作更快完成,尤其是在慢速文件系统上。如果未设置,则使用 transfer.unpackLimit 的值代替。

receive.maxInputSize

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

receive.denyDeletes

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

receive.denyDeleteCurrent

如果设置为 true,git-receive-pack 将拒绝删除非裸仓库当前检出分支的引用更新。

receive.denyCurrentBranch

如果设置为 true 或“refuse”,git-receive-pack 将拒绝更新非裸仓库当前检出分支的引用。这样的推送是潜在危险的,因为它会导致 HEAD 与索引和工作树不同步。如果设置为“warn”,则向 stderr 打印此类推送的警告,但允许推送继续进行。如果设置为 false 或“ignore”,则允许此类推送,不显示任何消息。默认值为“refuse”。

另一个选项是“updateInstead”,它在推送到当前分支时会更新工作树。此选项旨在用于同步工作目录,当其中一侧不易通过交互式 SSH 访问时(例如,一个实时网站,因此要求工作目录是干净的)。此模式在虚拟机中开发以测试和修复不同操作系统上的代码时也很有用。

默认情况下,“updateInstead”将拒绝推送,如果工作树或索引与 HEAD 有任何差异,但可以使用 push-to-checkout 钩子来定制此行为。参见 githooks[5]

receive.denyNonFastForwards

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

receive.hideRefs

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

receive.procReceiveRefs

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

例如,如果此变量设置为“refs/for”,则推送到“refs/for/master”之类的引用不会创建或更新名为“refs/for/master”的引用,而是可能通过运行“proc-receive”钩子直接创建或更新拉取请求。

可以在值开头提供可选修饰符,以筛选特定操作的命令:创建 (a)、修改 (m)、删除 (d)。修饰符中可以包含 ! 以否定引用前缀条目。例如:

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

如果设置为 true,git-receive-pack 在接收到 git-push 的数据并更新引用后,将运行 git-update-server-info。

receive.shallowUpdate

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

reftable.blockSize

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

建议使用对虚拟内存系统或文件系统友好的 2 的幂(例如 4KB 或 8KB)。更大的大小(64KB)可以带来更好的压缩,但读者在访问时可能会增加成本。

最大块大小为 16777215 字节(15.99 MiB)。默认值为 4096 字节(4KB)。值为 0 将使用默认值。

reftable.restartInterval

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

更频繁的重启点会降低前缀压缩效率并增加重启表占用的空间,两者都会增加文件大小。

较不频繁的重启点会使前缀压缩更有效,从而减小整体文件大小,但读者在二进制搜索步骤后遍历更多记录时会增加开销。

每个块最多支持 65535 个重启点。

默认值是每 16 条记录创建一个重启点。值为 0 将使用默认值。

reftable.indexObjects

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

默认值为 true

reftable.geometricFactor

每当 reftable 后端向堆栈追加新表时,它都会执行自动压缩以确保只有少数表。后端通过确保表在各自大小方面形成几何序列来实现这一点。

默认情况下,几何序列使用因子 2,这意味着对于任何表,下一个最大的表必须至少是其两倍大。支持的最大因子为 256。

reftable.lockTimeout

每当 reftable 后端向堆栈追加新表时,它必须在更新之前锁定中央的“tables.list”文件。此配置控制在另一个进程已获取锁的情况下,该进程将等待多长时间才能获取锁。值 0 表示完全不重试;-1 表示无限期重试。默认值为 100(即重试 100 毫秒)。

remote.pushDefault

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

remote.<name>.url

远程仓库的 URL。参见 git-fetch[1]git-push[1]。一个配置的远程可以有多个 URL;在这种情况下,第一个用于抓取,所有 URL 都用于推送(假设没有定义 remote.<name>.pushurl)。将此键设置为空字符串会清除 URL 列表,允许你覆盖先前的配置。

remote.<name>.pushurl

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

remote.<name>.proxy

对于需要 curl(http、https 和 ftp)的远程,用于该远程的代理 URL。设置为空字符串将禁用该远程的代理。

remote.<name>.proxyAuthMethod

对于需要 curl(http、https 和 ftp)的远程,用于向正在使用的代理进行身份验证的方法(可能在 remote.<name>.proxy 中设置)。参见 http.proxyAuthMethod

remote.<name>.fetch

git-fetch[1] 的默认“引用规格”集。参见 git-fetch[1]

remote.<name>.push

git-push[1] 的默认“引用规格”集。参见 git-push[1]

remote.<name>.mirror

如果设置为 true,向此远程推送将自动表现得如同在命令行上给出了 --mirror 选项。

remote.<name>.skipDefaultUpdate

remote.<name>.skipFetchAll 的一个已弃用同义词(如果两者在配置文件中设置了不同的值,则使用最后出现的值)。

remote.<name>.skipFetchAll

如果设置为 true,则在使用 git-fetch[1]git-remote[1]update 子命令进行更新时,此远程将被跳过,并且 git maintenance 的预抓取任务会忽略它。

remote.<name>.receivepack

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

remote.<name>.uploadpack

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

remote.<name>.tagOpt

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

remote.<name>.vcs

将此值设置为 <vcs> 将使 Git 通过 git-remote-<vcs> 辅助程序与远程交互。

remote.<name>.prune

当设置为 true 时,默认从该远程抓取时,也会移除远程上不再存在的任何远程跟踪引用(如同在命令行上给出了 --prune 选项)。如果存在 fetch.prune 设置,则覆盖它。

remote.<name>.pruneTags

当设置为 true 时,默认从该远程抓取时,如果修剪已通过 remote.<name>.prunefetch.prune--prune 普遍激活,则也会移除远程上不再存在的任何本地标签。如果存在 fetch.pruneTags 设置,则覆盖它。

另请参见 remote.<name>.prunegit-fetch[1] 的 PRUNING 部分。

remote.<name>.promisor

当设置为 true 时,此远程将用于抓取 promisor 对象。

remote.<name>.partialclonefilter

从此 promisor 远程抓取时将应用的过滤器。更改或清除此值只会影响新提交的抓取。要为本地对象数据库中已存在的提交抓取相关对象,请使用 git-fetch[1]--refetch 选项。

remote.<name>.serverOption

从此远程抓取时使用的默认服务器选项集。这些服务器选项可以通过 --server-option= 命令行参数覆盖。

这是一个多值变量,空值可以在高优先级配置文件(例如仓库中的 .git/config)中使用,以清除从低优先级配置文件(例如 $HOME/.gitconfig)继承的值。

remote.<name>.followRemoteHEAD

当使用远程的配置引用规格抓取时,git-fetch[1] 应如何处理对 remotes/<name>/HEAD 的更新。默认值为 "create",如果远程上存在但本地不存在 remotes/<name>/HEAD,则会创建它;这不会触及已存在的本地引用。将其设置为 "warn" 会在远程值与本地值不同时打印一条消息;如果不存在本地引用,则其行为类似于 "create"。 "warn" 的一个变体是 "warn-if-not-$branch",其行为类似于 "warn",但如果远程上的 HEAD$branch,则会静默。将其设置为 "always" 会静默地将 remotes/<name>/HEAD 更新为远程上的值。最后,将其设置为 "never" 将永远不会更改或创建本地引用。

remotes.<group>

“git remote update <group>” 命令抓取的远程列表。参见 git-remote[1]

repack.useDeltaBaseOffset

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

repack.packKeptObjects

如果设置为 true,则使 git repack 的行为如同传递了 --pack-kept-objects 选项。详情参见 git-repack[1]。通常默认为 false,但如果正在写入位图索引(通过 --write-bitmap-indexrepack.writeBitmaps),则默认为 true

repack.useDeltaIslands

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

repack.writeBitmaps

当设置为 true 时,Git 在将所有对象打包到磁盘时(例如,运行 git repack -a 时)会写入位图索引。此索引可以加快为克隆和抓取创建后续包的“计数对象”阶段,但会占用一些磁盘空间并在初始重新打包时花费额外时间。如果创建了多个 packfile,则此设置无效。裸仓库默认为 true,否则为 false。

repack.updateServerInfo

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

repack.cruftWindow
repack.cruftWindowMemory
repack.cruftDepth
repack.cruftThreads

当生成一个 cruft pack 且命令行中未给出相应参数时,git-pack-objects[1] 使用的参数。默认值和含义请参见名称类似的 pack.* 配置变量。

rerere.autoUpdate

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

rerere.enabled

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

revert.reference

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

safe.bareRepository

指定 Git 将操作的裸仓库。当前支持的值有

  • all:Git 操作所有裸仓库。这是默认值。

  • explicit:Git 仅操作通过顶级 --git-dir 命令行选项或 GIT_DIR 环境变量指定的裸仓库(参见 git[1])。

    如果你的工作流程中不使用裸仓库,那么将 safe.bareRepository 设置为全局配置中的 explicit 可能会有益。这将保护你免受涉及克隆包含裸仓库的仓库并在该目录中运行 Git 命令的攻击。

    此配置设置仅在受保护的配置中受尊重(参见 SCOPES)。这可以防止不受信任的仓库篡改此值。

safe.directory

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

这是一个多值设置,即你可以通过 git config --add 添加多个目录。要重置安全目录列表(例如,覆盖系统配置中指定的任何此类目录),请添加一个空值的 safe.directory 条目。

此配置设置仅在受保护的配置中受尊重(参见 SCOPES)。这可以防止不受信任的仓库篡改此值。

此设置的值是插值的,即 ~/<path> 扩展为相对于主目录的路径,而 %(prefix)/<path> 扩展为相对于 Git(运行时)前缀的路径。

要完全选择退出此安全检查,请将 safe.directory 设置为字符串 *。这将允许所有仓库被视为其目录已列在 safe.directory 列表中。如果在系统配置中设置了 safe.directory=* 并且你希望重新启用此保护,则在列出你认为安全的仓库之前,请使用空值初始化你的列表。在目录后附加 /* 将允许访问指定目录下的所有仓库。

如前所述,Git 默认只允许你访问自己拥有的仓库,即运行 Git 的用户。然而,当 Git 在提供 sudo 的非 Windows 平台上作为 root 运行时,git 会检查 sudo 创建的 SUDO_UID 环境变量,并允许访问其值中记录的 uid 以及 root 的 id。这是为了便于在安装过程中执行常见的序列“make && sudo make install”。在 sudo 下运行的 git 进程以 root 身份运行,但 sudo 命令会导出环境变量以记录原始用户的 ID。如果你不喜欢这种行为,并且希望 git 只信任由 root 拥有的仓库,那么你可以在调用 git 之前从 root 的环境中移除 SUDO_UID 变量。

sendemail.identity

一个配置身份。如果给定,会使 sendemail.<identity> 小节中的值优先于 sendemail 小节中的值。默认身份是 sendemail.identity 的值。

sendemail.smtpEncryption

详情参见 git-send-email[1]。请注意,此设置不受 identity 机制的约束。

sendemail.smtpSSLCertPath

CA 证书的路径(可以是目录或单个文件)。设置为空字符串可禁用证书验证。

sendemail.<identity>.*

下面找到的 sendemail.* 参数的特定身份版本,当通过命令行或 sendemail.identity 选择此身份时,它们将优先于其他参数。

sendemail.multiEdit

如果为 true(默认),将启动单个编辑器实例来编辑你需要编辑的文件(使用 --annotate 时是补丁,使用 --compose 时是摘要)。如果为 false,文件将一个接一个地编辑,每次都会启动一个新的编辑器。

sendemail.confirm

设置发送前是否确认的默认值。必须是 alwaysnevercccomposeauto 之一。这些值的含义参见 git-send-email[1] 文档中的 --confirm

sendemail.mailmap

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

sendemail.mailmap.file

git-send-email[1] 特定补充 mailmap 文件的位置。默认 mailmap 和 mailmap.file 首先加载。因此,此文件中的条目优先于默认 mailmap 位置中的条目。参见 gitmailmap[5]

sendemail.mailmap.blob

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

sendemail.aliasesFile

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

sendemail.aliasFileType

sendemail.aliasesFile 中指定的文件格式。必须是 muttmailrcpineelmgnussendmail 之一。

每种格式的别名文件外观可以在同名电子邮件程序的文档中找到。与标准格式的区别和限制如下所述:

sendmail
  • 不支持带引号的别名和带引号的地址:包含 " 符号的行将被忽略。

  • 不支持重定向到文件(/path/name)或管道(|command)。

  • 不支持文件包含(:include: /path/name)。

  • 对于任何明确不支持的构造以及解析器无法识别的任何其他行,都会在标准错误输出中打印警告。

sendemail.annotate
sendemail.bcc
sendemail.cc
sendemail.ccCmd
sendemail.chainReplyTo
sendemail.envelopeSender
sendemail.from
sendemail.headerCmd
sendemail.signedOffByCc
sendemail.smtpPass
sendemail.suppressCc
sendemail.suppressFrom
sendemail.to
sendemail.toCmd
sendemail.smtpDomain
sendemail.smtpServer
sendemail.smtpServerPort
sendemail.smtpServerOption
sendemail.smtpUser
sendemail.thread
sendemail.transferEncoding
sendemail.validate
sendemail.xmailer

这些配置变量都为 git-send-email[1] 命令行选项提供了默认值。详情请参见其文档。

sendemail.signedOffCc(已弃用)

sendemail.signedOffByCc 的已弃用别名。

sendemail.smtpBatchSize

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

sendemail.smtpReloginDelay

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

sendemail.forbidSendmailVariables

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

sequence.editor

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

showBranch.default

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

sparse.expectFilesOutsideOfPatterns

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

默认值为 false,这允许 Git 自动从索引和工作树中的文件列表不同步的情况中恢复。

如果你在的设置中,存在某个外部因素解除了 Git 维护工作树文件存在与稀疏模式之间一致性的责任,则将此设置为 true。例如,如果你有一个 Git 感知的虚拟文件系统,它具有基于访问模式使工作树和稀疏模式保持最新状态的健壮机制。

无论此设置如何,除非启用稀疏检出,否则 Git 不会检查那些“存在但已跳过”的文件,因此除非 core.sparseCheckouttrue,否则此配置选项无效。

splitIndex.maxPercentChange

使用分离索引功能时,此设置指定了分离索引中条目与分离索引和共享索引中总条目数之比的百分比,在此百分比达到后才会写入新的共享索引。该值应在 0 到 100 之间。如果值为 0,则始终写入新的共享索引;如果为 100,则从不写入新的共享索引。默认值为 20,因此如果分离索引中的条目数超过总条目数的 20%,则会写入新的共享索引。参见 git-update-index[1]

splitIndex.sharedIndexExpire

使用分离索引功能时,在创建新的共享索引文件时,自此变量指定时间以来未被修改的共享索引文件将被移除。“now”值会立即使所有条目过期,“never”则完全抑制过期。默认值为“2.weeks.ago”。请注意,每当基于共享索引文件创建新的分离索引文件或从共享索引文件读取时,该共享索引文件都被视为已修改(出于过期目的)。参见 git-update-index[1]

ssh.variant

默认情况下,Git 根据配置的 SSH 命令的基本名称(使用环境变量 GIT_SSHGIT_SSH_COMMAND 或配置设置 core.sshCommand 配置)确定要使用的命令行参数。如果基本名称无法识别,Git 将尝试通过首先使用 -G(打印配置)选项调用配置的 SSH 命令来检测 OpenSSH 选项的支持,然后将使用 OpenSSH 选项(如果成功)或除了主机和远程命令之外不使用任何选项(如果失败)。

可以设置配置变量 ssh.variant 来覆盖此检测。有效值包括 ssh(使用 OpenSSH 选项)、plinkputtytortoiseplinksimple(除了主机和远程命令外不带任何选项)。可以使用 auto 值显式请求默认的自动检测。任何其他值都将被视为 ssh。此设置也可以通过环境变量 GIT_SSH_VARIANT 覆盖。

每种变体当前使用的命令行参数如下:

  • ssh - [-p port] [-4] [-6] [-o option] [username@]host command

  • simple - [username@]host command

  • plink or putty - [-P port] [-4] [-6] [username@]host command

  • tortoiseplink - [-P port] [-4] [-6] -batch [username@]host command

除了 simple 变体外,命令行参数可能会随着 Git 添加新功能而改变。

stash.showIncludeUntracked

如果设置为 true,git stash show 命令将显示暂存条目的未跟踪文件。默认为 false。参见 git-stash[1]show 命令的描述。

stash.showPatch

如果设置为 true,git stash show 命令在不带任何选项的情况下将以补丁形式显示暂存条目。默认为 false。参见 git-stash[1]show 命令的描述。

stash.showStat

如果设置为 true,git stash show 命令在不带任何选项的情况下将显示暂存条目的 diffstat。默认为 true。参见 git-stash[1]show 命令的描述。

status.relativePaths

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

status.short

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

status.branch

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

status.aheadBehind

对于非 porcelain 状态格式,在 git-status[1] 中,设置为 true 默认启用 --ahead-behind,设置为 false 默认启用 --no-ahead-behind。默认为 true。

status.displayCommentPrefix

如果设置为 true,git-status[1] 将在每行输出前插入一个注释前缀(默认以 core.commentChar,即 # 开始)。这是 Git 1.8.4 及以前版本中 git-status[1] 的行为。默认为 false。

status.renameLimit

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

status.renames

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

status.showStash

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

status.showUntrackedFiles

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

  • no - 不显示未跟踪文件。

  • normal - 显示未跟踪的文件和目录。

  • all - 也显示未跟踪目录中的单个文件。

如果未指定此变量,则默认为 normal。布尔值 true 的所有常用拼写都被视为 normalfalse 则视为 no。此变量可以通过 git-status[1]git-commit[1] 的 -u|--untracked-files 选项来覆盖。

status.submoduleSummary

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

submodule.<name>.url

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

submodule.<name>.update

子模块通过 git submodule update 更新的方法,这是唯一受影响的命令,其他命令如 git checkout --recurse-submodules 不受影响。它存在是出于历史原因,当时 git submodule 是唯一与子模块交互的命令;像 submodule.activepull.rebase 这样的设置更具体。它由 git submodule initgitmodules[5] 文件中填充。参阅 git-submodule[1]update 命令的描述。

submodule.<name>.branch

子模块的远程分支名称,由 git submodule update --remote 使用。设置此选项以覆盖 .gitmodules 文件中找到的值。详情请参阅 git-submodule[1]gitmodules[5]

submodule.<name>.fetchRecurseSubmodules

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

submodule.<name>.ignore

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

submodule.<name>.active

布尔值,指示子模块是否对 Git 命令感兴趣。此配置选项优先于 submodule.active 配置选项。详情请参阅 gitsubmodules[7]

submodule.active

一个重复字段,包含用于匹配子模块路径以确定子模块是否对 Git 命令感兴趣的路径规范。详情请参阅 gitsubmodules[7]

submodule.recurse

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

当设置为 true 时,可以通过 --no-recurse-submodules 选项停用它。请注意,某些缺少此选项的 Git 命令可能会调用受 submodule.recurse 影响的上述某些命令;例如 git remote update 将调用 git fetch,但没有 --no-recurse-submodules 选项。对于这些命令,一个变通方法是使用 git -c submodule.recurse=0 临时更改配置值。

以下列表显示了接受 --recurse-submodules 选项的命令以及它们是否受此设置支持。

  • checkout, fetch, grep, pull, push, read-tree, reset, restoreswitch 始终受支持。

  • clonels-files 不受支持。

  • branch 仅在启用 submodule.propagateBranches 时才受支持

submodule.propagateBranches

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

submodule.fetchJobs

指定同时抓取/克隆的子模块数量。正整数表示最多允许并行抓取这么多子模块。值为 0 将提供一个合理的默认值。如果未设置,则默认为 1。

submodule.alternateLocation

指定子模块在克隆时如何获取备用(alternate)对象库。可能的值是 no, superproject。默认假定为 no,这意味着不添加引用。当值设置为 superproject 时,要克隆的子模块会根据超级项目的备用对象库计算其备用位置。

submodule.alternateErrorStrategy

指定如何处理通过 submodule.alternateLocation 计算的子模块备用对象库的错误。可能的值是 ignore, info, die。默认值为 die。请注意,如果设置为 ignoreinfo,并且计算出的备用对象库出现错误,则克隆将继续,如同未指定备用对象库一样。

tag.forceSignAnnotated

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

tag.sort

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

tag.gpgSign

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

tar.umask

此变量可用于限制 tar 归档条目的权限位。默认值为 0002,这将关闭全局写入位。特殊值 "user" 表示将使用归档用户的 umask。参阅 umask(2) 和 git-archive[1]

Trace2 配置设置仅从系统和全局配置文件读取;不尊重仓库本地和工作树配置文件以及 -c 命令行参数。

trace2.normalTarget

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

trace2.perfTarget

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

trace2.eventTarget

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

  • 0false - 禁用目标。

  • 1true - 写入到 STDERR

  • [2-9] - 写入到已打开的文件描述符。

  • <absolute-pathname> - 以追加模式写入文件。如果目标已存在且是一个目录,则跟踪信息将写入到给定目录下的文件(每个进程一个文件)中。

  • af_unix:[<socket-type>:]<absolute-pathname> - 写入到 Unix 域套接字(在支持它们的平台上)。套接字类型可以是 streamdgram;如果省略,Git 将尝试两者。

trace2.normalBrief

布尔值。当为 true 时,正常输出中将省略 timefilenameline 字段。可能被 GIT_TRACE2_BRIEF 环境变量覆盖。默认为 false。

trace2.perfBrief

布尔值。当为 true 时,性能 (PERF) 输出中将省略 timefilenameline 字段。可能被 GIT_TRACE2_PERF_BRIEF 环境变量覆盖。默认为 false。

trace2.eventBrief

布尔值。当为 true 时,事件输出中将省略 timefilenameline 字段。可能被 GIT_TRACE2_EVENT_BRIEF 环境变量覆盖。默认为 false。

trace2.eventNesting

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

trace2.configParams

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

trace2.envVars

一个逗号分隔的“重要”环境变量列表,应记录在 trace2 输出中。例如,GIT_HTTP_USER_AGENT,GIT_CONFIG 将导致 trace2 输出包含列出 HTTP 用户代理覆盖和 Git 配置文件位置的事件(假设已设置)。可能被 GIT_TRACE2_ENV_VARS 环境变量覆盖。默认未设置。

trace2.destinationDebug

布尔值。当为 true 时,如果无法打开跟踪目标目的地进行写入,Git 将打印错误消息。默认情况下,这些错误被抑制,并且跟踪被静默禁用。可能被 GIT_TRACE2_DST_DEBUG 环境变量覆盖。

trace2.maxFiles

整数。当向目标目录写入跟踪文件时,如果这样做会超出此文件数量,则不写入额外的跟踪。相反,写入一个哨兵文件,它将阻止进一步跟踪到此目录。默认为 0,这会禁用此检查。

trailer.separators

此选项指定哪些字符被识别为尾注分隔符。默认情况下,只有 : 被识别为尾注分隔符,但 = 始终在命令行上被接受,以兼容其他 Git 命令。

此选项给出的第一个字符将作为默认字符,当此尾注的配置中未指定其他分隔符时使用。

例如,如果此选项的值为 "%=$",则只有使用 <key><sep><value> 格式,且 <sep> 包含 %=$,然后是空格的行才被视为尾注。并且 % 将是使用的默认分隔符,因此默认情况下,尾注将显示为:<key>% <value>(键和值之间将出现一个百分号和一个空格)。

trailer.where

此选项指定新尾注添加的位置。

它可以是 end(默认值)、startafterbefore

如果为 end,则每个新尾注将出现在现有尾注的末尾。

如果为 start,则每个新尾注将出现在现有尾注的开头,而不是末尾。

如果为 after,则每个新尾注将出现在具有相同 <key> 的最后一个尾注之后。

如果为 before,则每个新尾注将出现在具有相同 <key> 的第一个尾注之前。

trailer.ifexists

此选项允许选择当输入中已存在至少一个具有相同 <key> 的尾注时将执行的操作。

此选项的有效值是:addIfDifferentNeighbor(这是默认值)、addIfDifferentaddreplacedoNothing

对于 addIfDifferentNeighbor,只有在将添加新尾注的行上方或下方没有具有相同(<key>, <value>)对的尾注时,才会添加新尾注。

对于 addIfDifferent,只有在输入中没有已经存在的具有相同(<key>, <value>)对的尾注时,才会添加新尾注。

对于 add,即使输入中已经存在一些具有相同(<key>, <value>)对的尾注,也会添加新尾注。

对于 replace,将删除一个具有相同 <key> 的现有尾注,并添加新尾注。被删除的尾注将是距离新尾注添加位置最近的那个(具有相同 <key> 的)。

对于 doNothing,将不执行任何操作;也就是说,如果输入中已存在具有相同 <key> 的尾注,则不会添加新尾注。

trailer.ifmissing

此选项允许选择当输入中尚不存在任何具有相同 <key> 的尾注时将执行的操作。

此选项的有效值是:add(这是默认值)和 doNothing

对于 add,将添加一个新尾注。

对于 doNothing,将不执行任何操作。

trailer.<keyAlias>.key

为 <key> 定义一个 <keyAlias>。<keyAlias> 必须是 <key> 的一个前缀(不区分大小写)。例如,在 git config trailer.ack.key "Acked-by" 中,“Acked-by”是 <key>,而“ack”是 <keyAlias>。此配置允许在命令行上使用“ack”<keyAlias> 调用更短的 --trailer "ack:...",而不是更长的 --trailer "Acked-by:..."

在 <key> 的末尾,可以出现一个分隔符,然后是一些空格字符。默认情况下,唯一有效的分隔符是 :,但这可以使用 trailer.separators 配置变量进行更改。

如果键中存在分隔符,则在添加尾注时,它将覆盖默认分隔符。

trailer.<keyAlias>.where

此选项接受与 trailer.where 配置变量相同的值,并且它会覆盖该选项为具有指定 <keyAlias> 的尾注所指定的内容。

trailer.<keyAlias>.ifexists

此选项接受与 trailer.ifexists 配置变量相同的值,并且它会覆盖该选项为具有指定 <keyAlias> 的尾注所指定的内容。

trailer.<keyAlias>.ifmissing

此选项接受与 trailer.ifmissing 配置变量相同的值,并且它会覆盖该选项为具有指定 <keyAlias> 的尾注所指定的内容。

trailer.<keyAlias>.command

已弃用,建议使用 trailer.<keyAlias>.cmd。此选项的行为与 trailer.<keyAlias>.cmd 相同,不同之处在于它不将任何内容作为参数传递给指定命令。相反,子字符串 $ARG 的第一次出现会被替换为将作为参数传递的 <value>。

请注意,用户命令中的 $ARG 只会被替换一次,并且原始的 $ARG 替换方式不安全。

当为同一个 <keyAlias> 同时给定 trailer.<keyAlias>.cmdtrailer.<keyAlias>.command 时,将使用 trailer.<keyAlias>.cmd,而 trailer.<keyAlias>.command 将被忽略。

trailer.<keyAlias>.cmd

此选项可用于指定一个 shell 命令,该命令将被调用一次以自动添加具有指定 <keyAlias> 的尾注,然后每次指定 --trailer <keyAlias>=<value> 参数时都会再次调用,以修改此选项将生成的尾注的 <value>。

当指定命令首次被调用以添加具有指定 <keyAlias> 的尾注时,其行为如同在 "git interpret-trailers" 命令的开头添加了一个特殊的 --trailer <keyAlias>=<value> 参数,其中 <value> 被认为是该命令的标准输出,并去除任何前导和尾随的空白字符。

如果在命令行上也传递了某些 --trailer <keyAlias>=<value> 参数,则该命令将针对这些具有相同 <keyAlias> 的参数中的每一个再次调用一次。并且这些参数的 <value> 部分(如果有)将作为其第一个参数传递给该命令。这样,该命令就可以根据 --trailer <keyAlias>=<value> 参数中传递的 <value> 计算出新的 <value>。

transfer.credentialsInUrl

配置的 URL 可以包含纯文本凭据,形式为 <protocol>://<user>:<password>@<domain>/<path>。您可能希望警告或禁止使用此类配置(建议使用 git-credential[1])。这将在 git-clone[1]git-fetch[1]git-push[1] 以及任何其他直接使用配置 URL 的情况下使用。

请注意,这目前仅限于检测 remote.<name>.url 配置中的凭据;它不会检测 remote.<name>.pushurl 配置中的凭据。

您可能希望启用此功能以防止意外的凭据泄露,例如因为:

  • 您运行 Git 的操作系统或系统可能不提供或不允许您配置存储用户名和/或密码的配置文件的权限。

  • 即使提供了,将此类数据“静止”存储也可能以其他方式暴露您,例如备份过程可能将数据复制到另一个系统。

  • Git 程序将在命令行上将完整 URL 作为参数相互传递,这意味着在允许查看其他用户完整进程列表的系统上,凭据将暴露给其他非特权用户。在 Linux 上,procfs(5) 中记录的 "hidepid" 设置允许配置此行为。

    如果这些问题不适用于您,那么您可能无需担心由于在 Git 配置文件中存储敏感数据而导致的凭据泄露。如果您确实想使用此功能,请将 transfer.credentialsInUrl 设置为以下值之一:

  • allow (默认值):Git 将继续其活动而不发出警告。

  • warn:当解析包含纯文本凭据的 URL 时,Git 将向 stderr 写入警告消息。

  • die:当解析包含纯文本凭据的 URL 时,Git 将向 stderr 写入失败消息。

transfer.fsckObjects

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

设置后,当遇到格式错误的对象或指向不存在对象的链接时,抓取 (fetch) 或接收 (receive) 将中止。此外,还会检查各种其他问题,包括遗留问题(参阅 fsck.<msg-id>),以及潜在的安全问题,例如 .GIT 目录的存在或恶意 .gitmodules 文件(详情请参阅 v2.2.1 和 v2.17.1 的发行说明)。未来的版本中可能会添加其他健全性检查和安全检查。

在接收端,fsckObjects 失败将使这些对象无法访问,请参阅 git-receive-pack[1] 中的“QUARANTINE ENVIRONMENT”。在抓取端,格式错误的对象将改为在仓库中保持未引用状态。

由于 fetch.fsckObjects 实现的非隔离性质,不能像 receive.fsckObjects 那样依赖它来保持对象存储的干净。

由于对象在解包时会写入对象存储,因此即使“抓取”失败,也可能引入恶意对象,然后随后的“抓取”成功,因为只检查新的传入对象,而不检查已经写入对象存储的对象。不应依赖这种行为差异。将来,此类对象也可能针对“抓取”进行隔离。

目前,多疑者需要找到某种方式来模拟隔离环境,如果他们想要与“推送”相同的保护。例如,在内部镜像的情况下,分两步进行镜像:一步抓取不受信任的对象,然后进行第二次“推送”(这将使用隔离)到另一个内部仓库,并让内部客户端使用这个被推送到的仓库,或者禁止内部抓取,只在完整的“fsck”运行后(且在此期间没有发生新的抓取)才允许它们。

transfer.hideRefs

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

您也可以在引用名称前加上 ! 来否定该条目,明确地公开它,即使之前的条目已将其标记为隐藏。如果您有多个 hideRefs 值,则后面的条目会覆盖前面的条目(更具体的配置文件中的条目会覆盖不太具体的配置文件中的条目)。

如果正在使用命名空间,则在将每个引用与 transfer.hiderefs 模式匹配之前,会从引用中剥离命名空间前缀。为了在剥离之前匹配引用,请在引用名称前添加 ^。如果您同时使用 !^,则必须首先指定 !

例如,如果在 transfer.hideRefs 中指定了 refs/heads/master 并且当前命名空间是 foo,那么 refs/namespaces/foo/refs/heads/master 将从广告中省略。如果设置了 uploadpack.allowRefInWant,则 upload-pack 将在协议 v2 fetch 命令中处理 want-ref refs/heads/master,就像 refs/namespaces/foo/refs/heads/master 不存在一样。receive-pack 则仍然会广告引用指向的对象 ID,而不会提及其名称(即所谓的“.have”行)。

即使您隐藏了引用,客户端仍可能通过 gitnamespaces[7] 手册页“SECURITY”部分中描述的技术窃取目标对象;最好将私有数据保存在单独的仓库中。

transfer.unpackLimit

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

transfer.advertiseSID

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

transfer.bundleURI

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

transfer.advertiseObjectInfo

当为 true 时,服务器会通告 object-info 能力。默认为 false。

uploadarchive.allowUnreachable

如果为 true,则允许客户端使用 git archive --remote 请求任何树,无论其是否可从引用尖端访问。详情请参阅 git-upload-archive[1] 的“SECURITY”部分中的讨论。默认为 false

uploadpack.hideRefs

此变量与 transfer.hideRefs 相同,但仅适用于 upload-pack(因此只影响抓取,不影响推送)。尝试通过 git fetch 抓取隐藏引用将失败。另请参阅 uploadpack.allowTipSHA1InWant

uploadpack.allowTipSHA1InWant

uploadpack.hideRefs 生效时,允许 upload-pack 接受请求隐藏引用尖端对象的 fetch 请求(默认情况下,此类请求会被拒绝)。另请参阅 uploadpack.hideRefs。即使此项为 false,客户端也可能通过 gitnamespaces[7] 手册页“SECURITY”部分描述的技术窃取对象;最好将私有数据保存在单独的仓库中。

uploadpack.allowReachableSHA1InWant

允许 upload-pack 接受请求可从任何引用尖端访问的对象的 fetch 请求。但是,请注意计算对象可达性是计算开销大的操作。默认为 false。即使此项为 false,客户端也可能通过 gitnamespaces[7] 手册页“SECURITY”部分描述的技术窃取对象;最好将私有数据保存在单独的仓库中。

uploadpack.allowAnySHA1InWant

允许 upload-pack 接受请求任何对象的 fetch 请求。它隐含了 uploadpack.allowTipSHA1InWantuploadpack.allowReachableSHA1InWant。如果设置为 true,它将同时启用它们;如果设置为 false,它将同时禁用它们。默认情况下未设置。

uploadpack.keepAlive

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

uploadpack.packObjectsHook

如果设置了此选项,当 upload-pack 为客户端运行 git pack-objects 来创建 packfile 文件时,它将转而运行此 shell 命令。pack-objects 命令及其原本会运行的参数(包括开头的 git pack-objects)将附加到 shell 命令后。钩子的 stdin 和 stdout 将被视为 pack-objects 本身被运行。即,upload-pack 会将 intended for pack-objects 的输入提供给钩子,并期望在 stdout 上收到一个完整的 packfile 文件。

请注意,此配置变量仅在受保护的配置中指定时才有效(参见 SCOPES)。这是防止从不受信任的仓库拉取(fetch)的安全措施。

uploadpack.allowFilter

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

uploadpackfilter.allow

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

uploadpackfilter.<filter>.allow

显式允许或禁止与 <filter> 对应的对象过滤器,其中 <filter> 可以是以下之一:blob:noneblob:limitobject:typetreesparse:oidcombine。如果使用组合过滤器,则 combine 和所有嵌套的过滤器类型都必须被允许。默认为 uploadpackfilter.allow

uploadpackfilter.tree.maxDepth

仅当 <n> 不超过 uploadpackfilter.tree.maxDepth 的值时才允许 --filter=tree:<n>。如果设置了此项,它也隐含了 uploadpackfilter.tree.allow=true,除非此配置变量已设置。如果未设置,则无效果。

uploadpack.allowRefInWant

如果设置了此选项,upload-pack 将支持协议版本 2 fetch 命令的 ref-in-want 功能。此功能旨在方便负载均衡服务器,这些服务器可能由于复制延迟而无法拥有对其引用所指向的 OID 的相同视图。

url.<base>.insteadOf

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

请注意,任何协议限制都将应用于重写后的 URL。如果重写将 URL 更改为使用自定义协议或远程帮助程序,您可能需要调整 protocol.*.allow 配置以允许该请求。特别是,您期望用于子模块的协议必须设置为 always,而不是默认的 user。请参阅上面 protocol.allow 的描述。

url.<base>.pushInsteadOf

任何以该值开头的 URL 将不会被推送;相反,它将被重写为以 <base> 开头,并将结果 URL 作为推送目标。在某些站点提供大量仓库,并以多种访问方法提供服务,其中一些方法不允许推送的情况下,此功能允许人们指定一个只拉取(pull-only)的 URL,并让 Git 自动使用适当的 URL 进行推送,即使是该站点上从未见过的仓库。当有多个 pushInsteadOf 字符串匹配给定 URL 时,使用最长的匹配项。如果远程仓库有显式的 pushurl,Git 将忽略此远程仓库的此设置。

user.name
user.email
author.name
author.email
committer.name
committer.email

user.nameuser.email 变量决定了提交对象的 authorcommitter 字段中的内容。如果您需要不同的 authorcommitter,可以设置 author.nameauthor.emailcommitter.namecommitter.email 变量。所有这些都可以被 GIT_AUTHOR_NAMEGIT_AUTHOR_EMAILGIT_COMMITTER_NAMEGIT_COMMITTER_EMAILEMAIL 环境变量覆盖。

请注意,这些变量的 name 形式通常指某种形式的个人名称。有关这些设置的更多信息以及如果您正在寻找身份验证凭据,请参阅 git-commit[1]git[1] 的环境变量部分,以及 credential.username 选项。

user.useConfigOnly

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

user.signingKey

如果 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.prereleaseSuffix (已废弃)

已废弃的 versionsort.suffix 别名。如果 versionsort.suffix 已设置,则忽略。

versionsort.suffix

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

通过在此变量中指定一个后缀,任何包含该后缀的标签名将出现在相应主发布版本之前。例如,如果变量设置为“-rc”,则所有“1.0-rcX”标签将出现在“1.0”之前。如果多次指定,每个后缀一次,则配置中后缀的顺序将决定带有这些后缀的标签名的排序顺序。例如,如果“-pre”在配置中出现在“-rc”之前,则所有“1.0-preX”标签将列在任何“1.0-rcX”标签之前。主发布标签相对于具有各种后缀的标签的位置可以通过在这些其他后缀中指定空后缀来确定。例如,如果后缀“-rc”、“”、“-ck”和“-bfs”按此顺序出现在配置中,则所有“v4.8-rcX”标签首先列出,然后是“v4.8”,然后是“v4.8-ckX”,最后是“v4.8-bfsX”。

如果多个后缀匹配相同的标签名,则该标签名将根据在标签名中起始位置最早的后缀进行排序。如果有多个不同的匹配后缀在最早位置开始,则该标签名将根据这些后缀中最长的一个进行排序。如果它们位于多个配置文件中,则不同后缀之间的排序顺序是未定义的。

web.browser

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

worktree.guessRemote

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

worktree.useRelativePaths

使用相对路径(当为“true”)或绝对路径(当为“false”)链接工作树。这对于仓库和工作树可能在不同位置或环境之间移动的设置特别有用。默认为“false”。

请注意,将 worktree.useRelativePaths 设置为“true”意味着启用 extension.relativeWorktrees 配置(参见 git-config[1]),因此它与旧版本的 Git 不兼容。

BUG

当使用已废弃的 [section.subsection] 语法时,如果子节中至少包含一个大写字母,更改值将导致添加一个多行键而不是更改。例如,当配置如下所示时:

  [section.subsection]
    key = value1

然后运行 git config section.Subsection.key value2 将导致:

  [section.subsection]
    key = value1
    key = value2

GIT

Git[1] 套件的一部分

scroll-to-top