directory search
Guides gitattributes giteveryday gitglossary gitignore gitmodules gitrevisions gittutorial gitworkflows Administration git archive git bundle git clean git filter-branch git fsck git gc git instaweb git reflog Basic Snapshotting git add git commit git diff git mv git reset git rm git status Branching and Merging git branch git checkout git log git merge git mergetool git stash git tag Debugging git bisect git blame git grep Email git am git format-patch git request-pull git send-email External Systems git fast-import git svn Getting and Creating Projects git clone git init Git git annotate git archimport git bisect-lk2009 git check-attr git check-mailmap git check-ref-format git checkout-index git cherry git citool git column git credential git credential-cache git credential-store git cvsexportcommit git cvsimport git cvsserver git diff-files git diff-tree git difftool git fast-export git fetch-pack git fmt-merge-msg git get-tar-commit-id git gui git http-backend git http-fetch git http-push git imap-send git index-pack git interpret-trailers git ls-remote git ls-tree git mailinfo git mailsplit git merge-file git merge-index git merge-one-file git merge-tree git mktag git mktree git name-rev git notes git p4 git pack-objects git pack-redundant git pack-refs git parse-remote git patch-id git prune git prune-packed git quiltimport git receive-pack git remote-ext git remote-fd git remote-testgit git repack git replace git rerere git send-pack git sh-i18n git sh-setup git shell git show-branch git show-index git stripspace git unpack-file git unpack-objects git upload-archive git upload-pack git var git verify-commit git verify-tag git whatchanged git worktree Inspection and Comparison git describe git shortlog git show Miscellaneous api credentials api index gitcli gitcore tutorial gitcredentials gitcvs migration gitdiffcore githooks gitk gitnamespaces gitremote helpers gitrepository layout gitsubmodules gittutorial 2 gitweb gitweb.conf pack format User Manual Patching git apply git cherry-pick git rebase git revert Plumbing Commands git cat-file git check-ignore git commit-tree git count-objects git diff-index git for-each-ref git hash-object git ls-files git merge-base git read-tree git rev-list git rev-parse git show-ref git symbolic-ref git update-index git update-ref git verify-pack git write-tree Server Admin git daemon git update-server-info Setup and Config git git config git help Sharing and Updating Projects git fetch git pull git push git remote git submodule
characters

命名

git-config - 获取并设置存储库或全局选项

概要

git config [] [type] [--show-origin] [-z|--null] name [value [value_regex]]git config [] [type] --add name value git config [] [type] --replace-all name value [value_regex]git config [] [type] [--show-origin] [-z|--null] --get name [value_regex]git config [] [type] [--show-origin] [-z|--null] --get-all name [value_regex]git config [] [type] [--show-origin] [-z|--null] [--name-only] --get-regexp name_regex [value_regex]git config [] [type] [-z|--null] --get-urlmatch name URL git config [] --unset name [value_regex]git config [] --unset-all name [value_regex]git config [] --rename-section old_name new_name git config [] --remove-section name git config [] [--show-origin] [-z|--null] [--name-only] -l | --list git config [] --get-color name [default]git config [] --get-colorbool name [stdout-is-tty]git config [] -e | --edit

描述

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

通过使用该--add选项可以将多行添加到选项。如果您想要更新或取消可能出现在多行上的选项,则value_regex需要提供 POSIX 正则表达式。只有与正则表达式匹配的现有值才会更新或取消设置。如果要处理与正则表达式匹配的行,只需在前面添加一个感叹号(另请参阅示例)。

类型说明符可以是--int或者--bool,以git config确保变量具有给定类型并将该值转换为规范形式(对于int为简单十进制数,对于 bool 为 “true” 或 “false” 字符串),或者--path,它做了一些路径扩展(见--path下文)。如果没有传入类型说明符,则不会对该值执行检查或转换。

读取时,值从系统中,默认情况下,全局和本地资源库的配置文件,并选择阅读--system--global--local--file 可以用来告诉命令只从该位置(查看文件)来读取。

书写时,新的值写入到默认,并选择存储库本地配置文件--system--global--file 可以用来告诉命令写入到该位置(你可以说--local那不过是默认值)。

这个命令在发生错误时将失败并显示非零状态。一些退出代码是:

  • 该部分或键无效(ret = 1),

  • 没有提供部分或名称(ret = 2),

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

  • 配置文件不能被写入(ret = 4),

  • 你尝试去掉一个不存在的选项(ret = 5),

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

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

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

选项

--replace-all

默认行为是最多替换一行。这将替换与该键匹配的所有行(以及可选的 value_regex )。

--add

在选项中添加新行而不更改任何现有值。这与提供^$value_regex in 相同--replace-all

--get

获取给定键的值(可选用与值匹配的正则表达式进行过滤)。如果未找到该键,则返回错误代码1,如果找到多个键值,则返回上一个值。

--get-all

像 get 一样,但返回多值键的所有值。

--get-regexp

像--get-all一样,但将该名称解释为正则表达式并写出键名称。正则表达式匹配目前是区分大小写的,并且针对小节和变量名称小写的密钥的规范化版本进行,但小节名称不是。

--get-urlmatch name URL

当给定一个由两部分组成的名称 section.key 时,会返回部分 .key 的值,该部分的 部分与给定 URL 匹配的最佳部分将返回(如果不存在此类键,则使用 section.key 的值作为后备)。当仅给出该部分作为名称时,请为该部分中的所有键执行此操作并列出它们。如果找不到值,则返回错误代码1。

--global

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

阅读选项:只能从全局文件读取~/.gitconfig$XDG_CONFIG_HOME/git/config而不能从所有可用文件中读取。

另请参阅文件。

--system

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

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

另请参阅文件。

--local

编写选项:写入存储库.git/config文件。这是默认行为。

阅读选项:只能从存储库中读取,.git/config而不能从所有可用文件中读取。

另请参阅文件。

-f config-file --file config-file

使用给定的配置文件而不是 GIT_CONFIG 指定的配置文件。

--blob blob

类似于--file使用给定的 blob 而不是文件。例如,您可以使用master:.gitmodules.gitmodules主分支中的文件读取值。请参阅 gitrevisions [7]中的“指定修订”一节以获取拼写 blob 名称拼写方法的更完整列表。

--remove-section

从配置文件中删除给定的部分。

--rename-section

将给定部分重命名为新名称。

--unset

从配置文件中删除与密钥匹配的行。

--unset-all

从配置文件中删除所有与密钥匹配的行。

-l --list

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

--bool

git config将确保输出为“真”或“假”

--int

git config将确保输出是一个简单的十进制数。在输出前,可选值后缀为kmg在配置文件中将使该值乘以1024,1048576或1073741824。

--bool-or-int

git config将确保输出匹配 --bool 或 --int 的格式,如上所述。

--path

git-config将扩展为指定用户的主目录~的值$HOME~user主目录。此设置在设置值时不起作用(但您可以git config bla ~/从命令行使用 shell 来扩展)。

-z --null

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

--name-only

输出--list--get-regexp的配置变量的名称。

--show-origin

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

--get-colorbool name stdout-is-tty

找到name(例如color.diff)的颜色设置并输出“true”或“false”。stdout-is-tty应该是“真”或“假”,并且在配置时称为“自动”时将其考虑在内。如果stdout-is-tty缺少,则检查命令本身的标准输出,如果要使用颜色,则退出状态0,否则退出状态1。当颜色设置为name未定义时,该命令将color.ui用作回退。

--get-color name default

查找为name(例如color.diff.new)配置的颜色并将其作为 ANSI 颜色转义序列输出到标准输出。default如果没有配置颜色,则使用可选参数name

-e --edit

打开一个编辑器来修改指定的配置文件; 或者--system--global或者存储库(默认)。

--no-includes

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

Files

如果没有明确设置--file,有四个文件git config将搜索配置选项:

$(prefix)/etc/gitconfig

系统范围的配置文件。

$XDG_CONFIG_HOME/git/config

第二个用户特定的配置文件。如果 $ XDG_CONFIG_HOME 未设置或为空,$HOME/.config/git/config将被使用。此文件中设置的任何单值变量都将被任何内容覆盖~/.gitconfig。如果你有时使用旧版本的 Git ,不建立这个文件是一个好主意,因为对这个文件的支持最近被添加了。

~/.gitconfig

用户特定的配置文件。也称为“全局”配置文件。

$GIT_DIR/config

存储库特定的配置文件。

如果没有其他选项,所有阅读选项将读取所有可用的这些文件。如果全局配置文件或全系统配置文件不可用,它们将被忽略。如果存储库配置文件不可用或不可读,git config将以非零错误代码退出。但是,在任何情况下都不会发布错误消息。

这些文件按照上面给出的顺序读取,其中最后一个值优先于先前读取的值。当多个值被采用时,将使用来自所有文件的密钥的所有值。

使用该-c选项运行任何 git 命令时,您可以覆盖单个配置参数。有关详细信息,请参阅 git [1]。

所有编写选项将默认写入存储库特定的配置文件。请注意,这也会影响诸如--replace-all和的选项--unsetgit config一次只能更改一个文件

您可以通过命令行选项或环境变量来覆盖这些规则。在--global--system选项将限制分别用于全球或全系统文件的文件。该GIT_CONFIG环境变量有类似的效果,但您可以指定任何你想要的文件名。

环境

GIT_CONFIG

从给定文件取代 .git / config 的配置。使用 “--global” 选项将强制使用 〜/ .gitconfig 。使用 “--system” 选项将强制使用 $(prefix)/ etc / gitconfig 。

GIT_CONFIG_NOSYSTEM

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

另请参阅文件。

例子

给定一个像这样的 .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 core.filemode true

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

% git config core.gitproxy '"ssh" for kernel.org' 'for kernel.org$'

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

要删除重命名的条目,请执行

% git config --unset diff.renames

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

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

% git config --get core.filemode

% git config core.filemode

或者,查询多变量:

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

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

% git config --get-all core.gitproxy

如果你喜欢危险的生活,你可以用一个新的 core.gitproxy 替换掉所有的core.gitproxy

% git config --replace-all core.gitproxy ssh

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

% git config core.gitproxy ssh '! for '

要实际上只将值与感叹号匹配,您必须

% git config section.key value '[!]'

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

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

在脚本中使用来自配置的自定义颜色的示例:

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

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

% git config --bool --get-urlmatch http.sslverify https://good.example.comtrue% git config --bool --get-urlmatch http.sslverify https://weak.example.comfalse% git config --get-urlmatch http https://weak.example.com http.cookieFile /tmp/cookie.txt http.sslverify false

配置文件

Git 配置文件包含许多影响 Git 命令行为的变量。.git/config每个存储库中的文件都用于存储该存储库的配置,并$HOME/.gitconfig用于将每个用户的配置存储为该.git/config文件的后备值。该文件/etc/gitconfig可用于存储系统范围的默认配置。

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

句法

语法相当灵活和宽容; 空格大多被忽略。在#;字符开头的注释行的末尾,空行被忽略。

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

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

[section "subsection"]

小节名称区分大小写,可以包含除换行符以外的任何字符(双引号"和反斜线可以通过分别将它们转义为\"\\)来包含。节标题不能跨越多行。变量可能直接属于某个部分或给定的子部分。你可以有[section],如果你有[section "subsection"],但你并不需要。

还有一个不赞成的[section.subsection]语法。使用该语法,子部分名称将转换为小写,并且也将区分大小写。这些小节名称遵循与节名称相同的限制。

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

定义一个值的行可以通过以\结尾来继续到下一行; 反引号和行结束被剥离。领先后的空格name =中,第一个注释字符后,该行剩余部分#;和该行的尾部空格被丢弃,除非它们是双引号括起来。价值范围内的内部空白是逐字保留的。

在双引号内,必须转义双引号"和反斜线\字符:use\"for"and\\for\

以下转义序列(旁边\"\\)被识别:\n换行符(NL),\t水平制表符(HT,TAB)和\b退格符(BS)。其他char转义序列(包括八进制转义序列)无效。

包括

includeincludeIf部分允许您包括来自其他来源的配置指令。这些部分的行为彼此完全相同,includeIf只是如果部分条件未评估为真,部分可能会被忽略; 请参阅下面的“有条件包含”。

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

包含文件的内容会立即插入,就好像它们已经在 include 指令的位置找到一样。如果变量的值是相对路径,则路径被认为是相对于在其中找到 include 指令的配置文件。见下面的例子。

有条件的包括

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

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

gitdir

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

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

该模式可以包含标准通配符通配符和另外两个,**/并且/**可以匹配多个路径组件。详情请参阅 gitignore [5] 。为了方便:

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

  • 如果模式开始是./,则将其替换为包含当前配置文件的目录。

  • 如果模式不以任何启动~/./或者/**/将被自动加上。例如,模式foo/bar变成**/foo/bar并且将匹配/any/path/to/foo/bar

  • 如果模式结束/**将自动添加。例如,模式foo/变成foo/**。换句话说,它会递归匹配 “foo” 和里面的所有内容。

gitdir/i

这与gitdir除了不区分大小写匹配相同(例如对大小写不敏感的文件系统)

关于通过gitdirgitdir/i匹配的更多注意事项:

  • $GIT_DIR匹配前不解析符号链接。

  • 符号链接和实际路径版本的路径都将在外部匹配$GIT_DIR。例如,如果〜/ Git 是一个符号链接到/ mnt /存储/ 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

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

boolean

当称取一个布尔值的变量,许多同义词接受truefalse; 这些都是不区分大小写的。

true

布尔真正的文字是yesontrue,和1。另外,没有定义的变量= 被视为是真的。

false

布尔值 false 文字是noofffalse0和空字符串。

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

integer

指定各种大小的许多变量的值可以后缀为kM...以表示“将数字缩放1024”,“由1024x1024”等。

color

采用颜色的变量的值是颜色列表(最多两个,一个用于前景,一个用于背景)和属性(尽可能多),用空格分隔。

接受基本的颜色normalblackredgreenyellowbluemagentacyanwhite。第一种颜色是前景; 第二个是背景。

颜色也可以用0到255之间的数字给出; 这些使用 ANSI 256色模式(但请注意,并非所有终端都可以支持此模式)。如果你的终端支持它,你也可以指定24位的 RGB 值,如十六进制#ff0ab3

接受的属性bolddimulblinkreverseitalic,和strike(用于打叉或“删除线”字母)。任何属性相对于颜色的位置(之前,之后或之间)无关紧要。特定属性可以用前缀被关闭nono-(例如,noreverseno-ul等等)。

一个空的颜色字符串根本不产生颜色效果。这可以用来避免在完全禁用颜色的情况下着色特定元素。

对于 git 的预定义颜色槽,这些属性意味着在彩色输出中每个项目的开始处重置。因此,即使在同一输出行上的前一个事物(例如,在log --decoratebold输出中的分支名称列表之前的开放圆括号)设置为使用其他属性进行绘制,设置color.decorate.branchblack将以明文形式black绘制该分支名称。然而,自定义日志格式可能会做更复杂和分层的着色,否定形式可能在那里很有用。

路径

该接受的路径名值的变量可以给出以“开始的字符串~/”或“~user/”,和通常的波浪线扩展发生这样的字符串:~/扩展到的值$HOME,和~user/被指定的用户的主目录。

变量

请注意,此列表不全面,不一定完整。对于特定于命令的变量,您可以在相应的手册页中找到更详细的说明。

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

advice.*

这些变量控制旨在帮助新用户的各种可选帮助消息。所有的advice.*变量默认为true,你可以通过设置这些变量来告诉 Git 你不需要帮助来处理这些false

pushUpdateRejected

设置这个变量false,如果要禁用pushNonFFCurrentpushNonFFMatchingpushAlreadyExistspushFetchFirst,和pushNeedsForce同时进行。

pushNonFFCurrent

由于对当前分支的非快进更新,git-push [1] 失败时显示的建议。

pushNonFFMatching

当您运行 git-push [1] 并matching refs显式推送(即您使用:或指定了不是您当前分支的 refspec )时显示的建议,并导致非快进错误。

pushAlreadyExists

当 git-push [1] 拒绝不符合快速转发资格的更新时显示(例如,标签)。

pushFetchFirst

当 git-push [1] 拒绝试图覆盖指向我们没有的对象的远程参考的更新时显示。

pushNeedsForce

当 git-push [1] 拒绝尝试覆盖指向非 commit-ish 对象的远程 ref 的更新或使远程 ref 位于非 commit-ish 对象时显示。

statusHints

在 git-status [1] 的输出中显示如何从当前状态开始,在 git-commit [1] 中写入提交消息时显示的模板中以及 git-checkout [1] 显示的帮助消息中显示方向。切换分支时。

statusUoption

建议考虑使用-ugit-status [1]选项,当命令需要2秒钟以上才能枚举未跟踪的文件。

commitBeforeMerge

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

resolveConflict

在冲突阻止执行操作时由各种命令显示的建议。

implicitIdentity

当您的信息从系统用户名和域名中被猜出时,提供关于如何设置您的身份配置的建议。

detachedHead

当您使用 git-checkout [1] 移至分离 HEAD 状态时,显示的建议指示如何在事实之后创建本地分支。

amWorkDir

在 git-am [1] 未能应用时显示补丁文件位置的建议。

rmHints

如果 git-rm [1] 输出失败,请指示如何从当前状态继续。

addEmbeddedRepo

当你意外地在另一个 git 仓库中添加了一个 git 仓库时,建议做些什么。

core.fileMode

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

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

但是,存储库可能位于正确处理文件模式的文件系统上,并且该变量true在创建时设置为,但后来可以从其他丢失文件模式的环境访问(例如,通过 CIFS 挂载导出 ext4 ,访问创建的 Cygwin 用于 Windows 或 Eclipse 的 Git 仓库)。在这种情况下,可能需要将此变量设置为false。参见 git-update-index [1]。

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

core.hideDotFiles

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

core.ignoreCase

如果为 true,则此选项启用各种解决方法,以使 Git 能够更好地处理不区分大小写的文件系统,如 FAT 。例如,如果一个目录列表在 Git 期望 “Makefile” 时发现 “makefile” ,Git 会认为它是真正的同一个文件,并继续记住它为 “Makefile” 。

缺省值为 false,除非 git-clone [1] 或 git-init [1] 将在创建存储库时探测并设置 core.ignoreCase为true(如果适用)。

core.precomposeUnicode

此选项仅适用于 Git 的 Mac OS 实施。当 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 ,则不允许签出.git在 HFS +文件系统上认为等效的路径。默认为true在 Mac OS 和false其他地方。

core.protectNTFS

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

core.trustctime

如果为 false ,索引和工作树之间的 ctime 差异将被忽略; 当 inode 更改时间由 Git(文件系统搜寻器和某些备份系统)之外的某些东西定期修改时,这一点很有用。参见 git-update-index [1]。默认情况下为真。

core.splitIndex

如果为 true,则将使用索引的分割索引功能。参见 git-update-index [1]。默认为 False。

core.untrackedCache

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

core.checkStat

确定在索引和工作树之间匹配哪些统计字段。用户可以将其设置为defaultminimal。默认(或明确default)是检查所有字段,包括 mtime 和 ctime 的第二部分。

core.quotePath

命令,输出路径(例如ls-filesdiff),将引用中的路径名“异常”的字符通过以相同的方式 C 逸出控制字符(例如,用反斜杠包围在双引号的路径名和避开这些字符\t用于TAB,\n对于LF,\\用于反斜杠)或值大于0x80的字节(例如\302\265UTF-8中的 “micro” 的八进制)。如果此变量设置为 false ,则高于0x80的字节不再被视为“异常”。无论此变量的设置如何,双引号,反斜杠和控制字符总是会被转义。一个简单的空间字符不被认为是“不寻常的”。许多命令可以使用该-z选项完全逐字输出路径名。默认值是 true 。

core.eol

text在 core.autocrlf 为 false 时,设置在工作目录中用于具有属性设置的文件的行结束类型。替代品是lfcrlf并且native,它使用平台的本地行结束。默认值是native。请参阅 gitattributes [5] 了解有关换行结束的更多信息。

core.safecrlf

如果为 true ,则使 Git 检查CRLF在行末换算处于活动状态时转换是否可逆。Git 将验证命令是直接还是间接地修改工作树中的文件。例如,提交文件后检出相同的文件应该在工作树中产生原始文件。如果当前设置不是这样core.autocrlf,Git 将拒绝该文件。变量可以设置为“警告”,在这种情况下,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所有文件和 core.eol 中的属性设置为 “auto” 为 “crlf” 相同。如果你想CRLF在你的工作目录中有行结尾并且存储库有 LF 行结束符,那么设置为 true 。该变量可以设置为input,在这种情况下不执行输出转换。

core.symlinks

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

缺省值为 true ,除了创建存储库时,git-clone [1] 或 git-init [1] 将探测并设置 core.symlinks为false(如果适用)。

core.gitProxy

command host port当使用 Git 协议进行抓取时,执行(as )“代理命令” 而不是建立与远程服务器的直接连接。如果变量值处于 “COMMAND for DOMAIN” 格式中,则该命令仅应用于以指定域字符串结尾的主机名。这个变量可以设置多次,并按照给定的顺序进行匹配; 第一场比赛获胜。

可以被GIT_PROXY_COMMAND环境变量覆盖(它总是普遍适用,没有特殊的 “for” 处理)。

特殊的字符串none可以用作代理命令来指定没有代理用于给定的域模式。这对排除防火墙内的服务器使用代理非常有用,而默认为外部域的通用代理。

core.sshCommand

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

core.ignoreStat

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

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

这对于 lstat()调用非常慢的系统非常有用,例如 CIFS / Microsoft Windows 。

默认为 False 。

core.preferSymlinkRefs

使用符号链接代替 HEAD 和其他符号参考文件的默认 “symref” 格式。有时需要使用旧的脚本来处理 HEAD ,这是一个符号链接。

core.bare

如果该属性值为 true ,则假定该存储库为bare并且没有与其关联的工作目录。如果是这种情况,需要工作目录的许多命令将被禁用,例如 git-add [1] 或 git-merge [1] 。

当创建仓库时,这个设置会被 git-clone [1] 或者 git-init [1] 自动猜到。默认情况下,以 “/.git” 结尾的存储库被假定为不是空(空=假),而所有其他存储库被假定为空(空=真)。

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 设置为“/不同/路径”),这很可能是错误配置。在 “/ path / to” 目录中运行 Git 命令仍然使用 “/ different / path” 作为工作树的根目录,除非你知道自己在做什么,否则会引起混淆(例如,你正在创建只读的快照相同的索引指向与存储库常用工作树不同的位置)。

core.logAllRefUpdates

启用 reflog 。$GIT_DIR/logs/通过附加新的和旧的 SHA-1 ,日期/时间和更新原因,但只有当文件存在时,才会将 ref 的更新记录到文件“ ”中。如果这个配置变量设置为true,缺少“$GIT_DIR/logs/”文件是自动创建的分支头(即下refs/heads/),远程裁判(即下refs/remotes/),注意裁判(即下refs/notes/),和符号 refHEAD。如果它被设置为always,那么会自动为任何下方的 ref 创建缺失的 reflogrefs/

此信息可用于确定“2天前”分支的提示是什么。

默认情况下,此值在具有与其关联的工作目录的存储库中为 true ,在裸存储库中默认为 false 。

core.repositoryFormatVersion

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

core.sharedRepository

group(或true)时,存储库可以在一个组中的多个用户之间共享(确保所有文件和对象都是可写组的)。当all(或worldeverybody)时,存储库将为所有用户可读,另外还可以分组。当umask(或false)时,Git 将使用由 umask(2)报告的权限。何时0xxx,哪里0xxx是八进制数,存储库中的文件将具有此模式值。0xxx将覆盖用户的 umask 值(而其他选项将只覆盖用户的 umask 值的所需部分)。示例:0660将使所有者和组能够进行 repo 读/写,但其他人无法访问(相当于group除非umask是例如0022)。0640是一个组可读但不可分组写的存储库。请参阅 git-init [1]。默认为False。

core.warnAmbiguousRefs

如果为 true,Git 会警告您,如果您传递的 ref 名称不明确,并且可能与存储库中的多个 ref 匹配。默认情况下为真。

core.compression

一个整数-1..9,表示默认的压缩级别。-1是 zlib 的默认值。0代表没有压缩,1..9代表不同的速度/尺寸折衷,9代表最慢。如果设置,则会为其他压缩变量(如core.looseCompression和)提供默认值pack.compression

core.looseCompression

一个整数-1..9,表示不在包文件中的对象的压缩级别。-1是 zlib 的默认值。0代表没有压缩,1..9代表不同的速度/尺寸折衷,9代表最慢。如果未设置,则默认为 core.compression 。如果没有设置,默认为1(最佳速度)。

core.packedGitWindowSize

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

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

常见的单元后缀kmg支持。

core.packedGitLimit

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

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

常见的单元后缀kmg支持。

core.deltaBaseCacheLimit

为了缓存可能被多个分类对象引用的基础对象而预留的最大字节数。通过将整个解压缩的基础对象存储在缓存中,Git 可以避免多次拆包和解压缩常用的基础对象。

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

常见的单元后缀kmg支持。

core.bigFileThreshold

大于此大小的文件将被缩减存储,而不会尝试增量压缩。在不进行增量压缩的情况下存储大文件可以避免过多的内存使用量,但会增加磁盘使用量。此外,大于此大小的文件始终视为二进制文件。

所有平台上的默认值为512 MiB 。对于大多数项目来说,这应该是合理的,因为源代码和其他文本文件仍然可以进行 delta 压缩,但是较大的二进制媒体文件不会。

常见的单元后缀kmg支持。

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( per-directory )之外.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] 的“描述”部分)。

这个配置变量在你希望集中配置你的 Git 钩子而不是在每个存储库上配置它们的情况下是有用的,或者作为一个更灵活和集中的替代方法来使init.templateDir你有一个你已经改变了默认钩子的地方。

core.editor

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

core.commentChar

诸如committag可让您编辑消息的命令考虑以该字符注释开头的行,并在编辑器返回后将其删除(默认#)。

如果设置为“auto”,git-commit将选择不是现有提交消息中任何行的开始字符的字符。

core.packedRefsTimeout

尝试锁定packed-refs文件时要重试的时间长度(以毫秒为单位)。值0意味着根本不会重试; -1意味着无限期地尝试。默认值是1000(即,重试1秒)。

sequence.editor

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

core.pager

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

LESS环境变量未设置时,Git 将其设置为FRX(如果LESS设置了环境变量,则 Git 根本不会更改它)。如果你想有选择地覆盖 Git 的默认设置LESS,你可以设置core.pager为例如less -S。这将通过 Git 传递给 shell ,该命令将最终命令转换为LESS=FRX less -S。环境不会设置该S选项,但命令行会执行此操作,从而减少截断长行的问题。同样,设置core.pagerless -+FF从命令行中禁用环境指定的选项,取消激活“如果一个屏幕退出”行为less。人们可以特别激活某些特定命令的标志:例如,设置pager.blameless -S启用行截断仅用于git blame

同样,当LV环境变量未设置时,Git 将其设置为-c。您可以通过LV使用另一个值或设置core.pager为导出来覆盖此设置lv +c

core.whitespace

用逗号分隔的常见空白问题列表需要注意。git diffcolor.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-space是一种短手为覆盖blank-at-eolblank-at-eof

  • cr-at-eol将行结束处的回车符视为行结束符的一部分,即使用它,trailing-space如果此回车符之前的字符不是空格(默认情况下未启用),则不会触发。

  • tabwidth=告诉标签占据多少个字符位置; 这indent-with-non-tab与 Git 修复tab-in-indent错误有关。默认的标签宽度是8.允许的值是1到63。

core.fsyncObjectFiles

这个布尔值将fsync()在写入目标文件时启用。

这是一个浪费时间和精力的文件系统,它可以正确地命令数据写入,但对于不使用日记功能(传统 UNIX 文件系统)的文件系统或只有日志元数据而不是文件内容( OS X的HFS +或 Linux 带有 “data = writeback” 的 ext3 )。

core.preloadIndex

为类似的操作启用并行索引预加载git diff

这可以加快像操作git diffgit status特别是像 NFS 有弱缓存语义,因此相对较高的 IO 延迟的文件系统。启用后,Git 将并行执行与文件系统数据的索引比较,从而允许重叠 IO 。默认为 true 。

core.createObject

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

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

core.notesRef

显示提交消息时,还会显示存储在给定 ref 中的注释。参考资料必须完全合格。如果给定的 ref 不存在,这不是错误,但意味着不应打印任何注释。

该设置默认为 “refs / notes / commits” ,并且可以被GIT_NOTES_REF环境变量覆盖。参见 git-notes [1] 。

core.sparseCheckout

启用“sparse checkout”功能。有关更多信息,请参阅 git-read-tree [1] 中的 “Sparse checkout” 一节。

core.abbrev

设置长度对象名称缩写为。如果未指定或设置为 “auto” ,则根据存储库中的打包对象的近似数量计算适当的值,这对于缩写对象名称在一段时间内保持唯一性来说足够了。最小长度是4。

add.ignoreErrors add.ignore-errors (deprecated)

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

alias.*

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

如果别名扩展以感叹号为前缀,则将其视为 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] 。

am.keepcr

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

am.threeWay

默认情况下,git am如果修补程序不能干净地应用,将会失败。当设置为true时,git am如果补丁记录了它应该应用到的斑点的标识,并且我们在本地提供了这些斑点(相当于--3way从命令行提供选项),则此设置将告诉回退3路合并。默认为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]。

branch.autoSetupMerge

告诉git branchgit checkout设置新分支,以便 git-pull [1] 将从起点分支适当合并。请注意,即使未设置此选项,也可以使用--track--no-track选项为每个分支选择此行为。有效的设置是:false- 没有自动设置完成;true- 当起始点是远程跟踪分支时,自动设置完成;always- 当起始点是本地分支或远程跟踪分支时,自动设置完成。该选项默认为 true 。

branch.autoSetupRebase

当一个新的分支被创建git branchgit checkout跟踪另一个分支时,这个变量告诉 Git 设置 pull 来代替合并(参见 “branch。 .rebase” )。何时never,rebase 永远不会自动设置为 true 。何时local,其他地方分行的追踪分行的 rebase 设置为 true 。remote对于远程跟踪分支的跟踪分支,当 rebase 设置为 true 时。何时always,所有跟踪分支的 rebase 将设置为 true 。有关如何设置分支以跟踪其他分支的详细信息,请参阅 “branch.autoSetupMerge” 。该选项默认为从不。

branch..remote

在分支<名称>上时,它会告知git fetch以及git push从哪个远程获取/推送。推送到远程可能会覆盖remote.pushDefault(对于所有分支机构)。推送到当前分支的远程可能会被进一步覆盖branch..pushRemote。如果没有配置远程设备,或者您不在任何分支上,则默认为origin进行抓取和remote.pushDefault推送。此外,.(一段时间)是当前的本地存储库(一个点存储库),请参见branch..merge下面的最终注释。

branch..pushRemote

在分支 上时,它将覆盖branch..remote推送。它也覆盖remote.pushDefault从分支 推送。当你从一个地方(例如你的上游)拉到另一个地方(例如你自己的发布库)时,你需要设置remote.pushDefault指定远程推送到所有分支,并使用这个选项覆盖特定的科。

branch..merge

与branch。 .remote 一起定义给定分支的上游分支。它告诉git fetch/git pull/git rebase该分支合并,也可以影响git push(见 push.default )。当在分支 中时,它告诉git fetch默认refspec被标记为在 FETCH_HEAD 中合并。该值的处理方式与 refspec 的远程部分相同,并且必须匹配从 “branch。 .remote” 给出的来自远程的 ref 。合并信息由git pull(首先调用git fetch)查找用于合并的默认分支使用。如果没有这个选项,git pull默认情况下合并第一个获取的 refspec 。指定多个值以获得章鱼合并。如果你想设置git pull以便它从本地存储库中的另一个分支合并到 中,可以将分支。 .merge 指向所需的分支,并使用分支的相对路径设置.(句点)。 .remote 。

branch..mergeOptions

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

branch..rebase

如果为 true,则在获取的分支上重新分支分支 ,而不是在运行 “git pull” 时将默认分支与默认分支合并。请参阅 “pull.rebase” 以非分支特定的方式执行此操作。

当保存时,也会传递--preserve-merges到,git rebase以便本地提交的合并提交不会因运行而变得平坦git pull

当值为时interactive,rebase 以交互模式运行。

注意:这是一个可能危险的操作; 你,除非你理解的含义使用它(请查看 git-rebase[1]了解详细信息)。

branch..description

分支描述,可以用编辑git branch --edit-description。分支描述将自动添加到格式补丁封面信或请求摘要中。

browser..cmd

指定要调用指定浏览器的命令。指定的命令在 shell 中使用作为参数传递的 URL 进行评估。(请参阅 git-web {litdd} 浏览[1]。)

browser..path

覆盖可能用于浏览 HTML 帮助的指定工具的路径(请参阅-wgit-help [1] 中的选项)或 gitweb 中的工作存储库(请参阅 git-instaweb [1] )。

clean.requireForce

一个布尔值使 git-clean 除非给出 -f ,-i 或 -n ,否则不会执行任何操作。默认为 true 。

color.branch

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

color.branch.

使用自定义颜色进行分支着色。current(当前分支),local(本地分支),remote(远程跟踪分支在 refs / remotes / ),upstream(上游跟踪分支),plain(其他参考)之一。

color.diff

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

这不会影响 git-format-patch [1] 或git-diff-*管道命令。可以使用该--color[=]选项在命令行上覆盖。

color.diff.

使用自定义颜色进行差异着色。指定补丁的哪个部分使用指定的颜色,并且是context(上下文文本 -plain是历史同义词),meta(元信息),frag( hunk 标题),func( hunk 标题中的功能),old(删除的行),new(添加的行),commit(提交标题)或whitespace(突出显示空白错误)。

color.decorate.

使用自定义颜色进行git log --decorate输出。是以下之一branchremoteBranchtagstashHEAD为本地分支机构,远程跟踪分支,标签,分别藏匿和 HEAD 。

color.grep

设置为always时,始终突出显示匹配项。何时false(或never),永远不会。设置为true或时auto,仅在输出写入终端时使用颜色。如果未设置,则使用该值color.uiauto默认情况下)。

color.grep.

使用自定义颜色进行 grep 着色。指定使用指定颜色的线的哪一部分,并且是其中之一

context

上下文行中不匹配的文本(使用-A-B,或-C

filename

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

function

功能名称行(使用时-p

linenumber

行号前缀(使用时-n

match

匹配的文本(同设定matchContextmatchSelected

matchContext

匹配上下文行中的文本

matchSelected

匹配选定行中的文本

selected

选定行中不匹配的文本

separator

上的线之间的字段分离器(:-,和=)和厚片之间(--

color.interactive

设置为时always,总是使用交互式提示和显示的颜色(例如 “git-add --interactive” 和 “git-clean --interactive” 使用的颜色)。当错误(或never),从不。设置为true或时auto,仅在输出到终端时才使用颜色。如果未设置,则使用该值color.uiauto默认情况下)。

color.interactive.

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

color.pager

当传呼机正在使用时启用/禁用彩色输出的布尔值(默认值为 true )。

color.showBranch

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

color.status

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

color.status.

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

color.ui

此变量确定变量的默认值,例如color.diffcolor.grep控制每个命令系列的颜色使用。随着更多命令学习配置以设置--color选项的默认值,其范围将扩大。将其设置为false或者never如果您希望 Git 命令不使用颜色,除非通过某些其他配置或--color选项明确启用。将它设置为always你希望不希望所有的输出机消费使用的颜色,来trueauto(这是因为 Git 的1.8.4默认值),如果你希望在写入到终端,输出使用的颜色。

column.ui

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

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

always

始终显示在列中

never

从不显示在列中

auto

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

这些选项控制布局(默认为column)。将上述任何暗示always,如果没有的alwaysneverauto指定。

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

此设置将覆盖该--cleanup选项的默认值git commit。有关详细信息,请参阅 git-commit [1] 。如果您始终想要#在日志消息中保留以注释字符开头的行,那么更改默认值可能很有用,在这种情况下您会这样做git config commit.cleanup whitespace(请注意,您必须自己移除#以提交日志模板开头的帮助行,如果你这样做)。

commit.gpgSign

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

commit.status

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

commit.template

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

commit.verbose

一个 boolean 或 int 来指定详细级别git commit。请参阅 git-commit [1] 。

credential.helper

指定需要用户名或密码凭证时调用的外部助手; 帮助者可以咨询外部存储器以避免提示用户输入凭证。请注意,可能会定义多个助手。有关详细信息,请参阅 gitcredentials [7] 。

credential.useHttpPath

在获取凭证时,请考虑 http 或 https URL 的“路径”组件非常重要。默认为 false 。请参阅 gitcredentials [7] 了解更多信息。

credential.username

如果没有为网络身份验证设置用户名,则默认使用此用户名。请参阅凭证。.* 以下和 gitcredentials [7] 。

credential..*

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

credentialCache.ignoreSIGHUP

Tell git-credential-cache—daemon to ignore SIGHUP, instead of quitting.

diff.autoRefreshIndex

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

diff.dirstat

以逗号分隔的--dirstat参数列表,指定--dirstat选项的默认行为,以 git-diff [1]and friends. The defaults can be overridden on the command line (using--dirstat = < param1,param2,... >). The fallback defaults (when not changed bydiff.dirstat) are更改,非累积,3`。以下参数可用:

changes

通过计算已从源中删除或添加到目标的行来计算 dirstat 数字。这会忽略文件中纯代码移动的数量。换句话说,重新排列文件中的行数不会与其他更改一样多。这是没有给出参数时的默认行为。

lines

通过执行常规基于行的差异分析来计算 dirstat 数字,并且将移除/添加的行数相加。(对于二进制文件,取而代之的是计算64字节的块,因为二进制文件没有自然的行概念)。这是一种--dirstatchanges行为更为昂贵的行为,但它可以像其他更改一样对文件中的重新排列的行进行计数。结果输出与您从其他--*stat选项中获得的结果一致。

files

通过计算更改的文件数量来计算 dirstat 数字。dirstat 分析中每个更改的文件都相同。这是计算上最便宜的--dirstat行为,因为它根本不需要查看文件内容。

cumulative

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

整数参数指定截断百分比(默认为3%)。输出中不显示贡献小于此百分比的目录。

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

diff.statGraphWidth

在 --stat 输出中限制图形部分的宽度。如果设置,则适用于所有生成 --stat 输出的命令,格式补丁除外。

diff.context

使用 行上下文生成差异,而不是缺省值3.此值由 -U 选项覆盖。

diff.interHunkContext

显示差异 hunk 之间的上下文,直到指定的行数,从而融合彼此接近的 hunk 。该值用作--inter-hunk-context命令行选项的默认值。

diff.external

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

diff.ignoreSubmodules

设置 --ignore 子模块的默认值。请注意,这仅影响git diff瓷器,而不影响较低等级的diff命令git diff-filesgit checkout在报告未提交的更改时也会尊重此设置。将其设置为all禁用通常显示的子模块摘要,git commit并设置git status何时status.submoduleSummary设置,除非使用 --ignore-submodules 命令行选项覆盖子摘要。该git submodule命令不受此设置的影响。

diff.mnemonicPrefix

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

git diff

比较(i)ndex 和(w)ork 树;

git diff HEAD

比较(c)ommit 和(w)ork 树;

git diff --cached

比较(c)ommit 和(i)ndex ;

git diff HEAD:file1 file2

比较(o)bject 和(w)ork 树实体;

git diff --no-index a b

比较两个非 Git 事物(1)和(2)。

diff.noprefix

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

diff.orderFile

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

diff.renameLimit

执行复制/重命名检测时要考虑的文件数量; 相当于git diff选项-l

diff.renames

Git 是否以及如何检测重命名。如果设置为 “false” ,则重命名检测被禁用。如果设置为 “true” ,则启用基本重命名检测。如果设置为“复制”或“复制”,Git 也会检测副本。默认为 true 。请注意,这只会影响git diff瓷器,如 git-diff [1] 和 git-log [1] ,而不是像 git-diff-files [1] 这样的低级命令。

diff.suppressBlankEmpty

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

diff.submodule

指定显示子模块差异的格式。“short” 格式只显示范围开始和结束处的提交名称。“日志”格式列出了像 git-submodule [1]summary这样的提交范围。“diff” 格式显示子模块已更改内容的内嵌比较。默认为“short”。

diff.wordRegex

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

diff..command

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

diff..xfuncname

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

diff..binary

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

diff..textconv

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

diff..wordRegex

diff 驱动程序应该用来将文本分成一行的正则表达式。有关详细信息,请参阅 gitattributes [5] 。

diff..cachetextconv

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

diff.tool

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

  • araxis

  • bc

  • bc3

  • codecompare

  • deltawalker

  • diffmerge

  • diffuse

  • ecmerge

  • emerge

  • examdiff

  • gvimdiff

  • gvimdiff2

  • gvimdiff3

  • kdiff3

  • kompare

  • meld

  • opendiff

  • p4merge

  • tkdiff

  • vimdiff

  • vimdiff2

  • vimdiff3

  • winmerge

  • xxdiff

diff.indentHeuristic

将此选项设置true为启用实验启发式方法,可以改变差异边界以使修补程序更易于阅读。

diff.algorithm

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

default,myers

基本 diff 算法。目前,这是默认设置。

minimal

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

patience

生成补丁时使用“耐心差异”算法。

histogram

该算法将耐心算法扩展为“支持低出现率的通用元素”。

diff.wsErrorHighlight

突出显示空白的错误contextold或者new把差异线。多个值以逗号分隔,none重置以前的值,default将列表重置为newall简写为old,new,context。空白错误使用了颜色color.diff.whitespace。命令行选项--ws-error-highlight=覆盖此设置。

difftool..path

覆盖给定工具的路径。如果您的工具不在 PATH 中,这非常有用。

difftool..cmd

指定用于调用指定的 diff 工具的命令。指定的命令在 shell 中用以下可用变量评估:LOCAL设置为包含 diff 预映像REMOTE内容的临时文件的名称,并设置为包含 diff 后映像内容的临时文件的名称。

difftool.prompt

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

fastimport.unpackLimit

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

fetch.recurseSubmodules

该选项可以设置为布尔值或设置为on-demand。将其设置为布尔变量时,会将抓取和拉动的行为更改为设置为 true 时无条件地递归到子模块中,或者在设置为 false 时将其无法递归。设置为on-demand(默认值)时,只有在其超级项目检索用于更新子模块参考的提交时,提取和拉取才会递归到已填充的子模块中。

fetch.fsckObjects

如果它设置为 true ,git-fetch-pack 将检查所有提取的对象。如果格式错误的对象或链接断开,它将中止。中止的结果只是悬挂的对象。默认为 false 。如果未设置,transfer.fsckObjects则使用其值。

fetch.unpackLimit

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

fetch.prune

如果为 true ,那么 fetch 将自动运行,就像--prune在命令行上给出选项一样。另见remote..prune

fetch.output

控制如何打印参考更新状态。有效值是fullcompact。默认值是full。有关详细信息,请参见 git-fetch [1] 中的 OUTPUT 部分。

format.attach

启用多部分/混合附件作为默认值format-patch。该值也可以是一个双引号字符串,它将启用附件作为默认值并将该值设置为边界。请参阅 git-format-patch [1] 中的 --attach 选项。

format.from

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

format.numbered

一个布尔值,可以启用或禁用补丁主题中的序列号。它默认为“自动”,只有在有多个补丁时才启用它。通过将其设置为 “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.signature

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

format.signatureFile

与 format.signature 一样工作,除了由该变量指定的文件内容将用作签名。

format.suffix

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

format.pretty

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

format.thread

默认的线程风格git format-patch。可以是布尔值或shallowordeepshallow线程使得每一封邮件都可以回复该系列的头部,头部从封面信件,--in-reply-to第一个补丁邮件中按顺序选择。deep线程使每个邮件回复到前一个邮件。一个真正的布尔值是相同的shallow,而一个错误的值会禁用线程。

format.signOff

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

format.coverLetter

一个布尔值,用于控制是否在调用 format-patch 时生成封面字母,但另外可以设置为“auto”,以便仅在存在多个修补程序时才生成封面字母。

format.outputDirectory

设置一个自定义目录来存储结果文件,而不是当前的工作目录。

format.useAutoBase

--base=auto默认情况下允许启用 format-patch 选项的布尔值。

filter..clean

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

filter..smudge

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

fsck.

允许覆盖特定消息标识的消息类型(错误,警告或忽略),例如missingEmail

为了方便起见,fsck 在错误/警告前添加了消息 ID,例如“missingEmail:invalid author / committer line - missing email”意味着该设置fsck.missingEmail = ignore将隐藏该问题。

此功能旨在支持使用旧版存储库,而这些存储库在不发生破坏性更改的情况下无法修复。

fsck.skipList

已知以非致命方式破坏的对象名称的排序列表(即每行一个 SHA-1)的路径应被忽略。如果尽早提交包含可安全忽略的错误(如无效的提交者电子邮件地址)的应用程序,则应接受已建立的项目,此功能非常有用。注意:使用此设置不能跳过损坏的对象。

gc.aggressiveDepth

深度参数用于由 delta 压缩算法使用git gc --aggressive。默认值为50。

gc.aggressiveWindow

窗口大小参数用于由 delta 压缩算法使用git gc --aggressive。这默认为250。

gc.auto

如果存储库中的这些松散对象的数量大约超过了这个数量,git gc --auto则会将它们打包。一些 Porcelain 命令使用此命令不时执行轻量级垃圾回收。默认值为6700.将其设置为0将禁用它。

gc.autoPackLimit

如果*.keep存储库中存在多个未标记文件的包,则会git gc --auto将它们合并到一个更大的包中。默认值为50.将其设置为0将禁用它。

gc.autoDetach

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

gc.logExpiry

如果文件 gc.log 存在,则git gc --auto不会运行,除非该文件比gc.logExpiry旧版本更老。默认是“1.day”。请参阅gc.pruneExpire更多指定其值的方法。

gc.packRefs

git pack-refs在存储库中运行会使其无法通过1.5.1.2之前的Git版本在诸如HTTP之类的哑传输上进行克隆。这个变量决定了是否git gc运行git pack-refs。可以将其设置为notbare在所有非裸回购库中启用它,或者可以将其设置为布尔值。默认是true

gc.pruneExpire

什么时候git gc运行,它会调用prune --expire 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..reflogExpire

git reflog expire删除比此时早的reflog条目; 默认为90天。值“now”立即使所有条目到期,并且“never”完全禁止到期。在中间,使用“”(例如“refs / stash”),该设置仅适用于匹配的ref。

gc.reflogExpireUnreachable gc..reflogExpireUnreachable

git reflog expire删除比这次更早的reflog条目,并且不能从当前提示中获得; 默认为30天。值“now”立即使所有条目到期,并且“never”完全禁止到期。在中间使用“”(例如“refs / stash”),该设置仅适用于匹配的ref。

gc.rerereResolved

您以前解决的冲突合并记录在git rerere gc运行时会保留这么多天。缺省值是60天。参见git-rerere [1]。

gc.rerereUnresolved

运行时,您尚未解决的冲突合并记录会保留多天git rerere gc。默认值是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。这会导致客户端将它们视为二进制文件,这会压制任何换行符,否则可能会这样做。或者,如果它被设置为“猜测”,则检查文件的内容以确定它是否是二进制的,类似于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 变量,除了gitcvs.usecrlfattrgitcvs.allBinary也可以被指定为gitcvs..(其中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]。

grep.lineNumber

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

grep.patternType

设置默认的匹配行为。使用值basicextendedfixed,或perl将启用--basic-regexp--extended-regexp--fixed-strings,或--perl-regexp相应的选项,而值default将返回到默认匹配行为。

grep.extendedRegexp

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

grep.threads

要使用的 grep 工作线程数。请参阅grep.threadsgit-grep [1] 以获取更多信息。

grep.fallbackToNoIndex

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

gpg.program

在制作或验证 PGP 签名时使用此自定义程序而不是“gpg$PATH。该程序必须支持与 GPG 相同的命令行界面,即验证分离的签名,“gpg --verify $file - <$signature”已运行,并且该程序应通过以代码0退出来发出良好的签名,并生成 ASCII 装甲的分离签名时,“gpg -bsau $key” 的标准输入将与要签名的内容一起提供,程序应将结果发送至其标准输出。

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]在执行提取时应修剪远程跟踪分支,则为“true”。默认值是“false”。

gui.trustmtime

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

gui.spellingDictionary

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

gui.fastCopyBlame

如果为 true,则git gui blame用于-C替代-C -C原始位置检测。它会以巨大的副本检测为代价,在巨大的存储库上大大加快责任。

gui.copyBlameThreshold

指定用于git gui blame原始位置检测的阈值,以字母数字字符度量。有关复制检测的更多信息,请参阅 git-blame [1]手册。

gui.blamehistoryctx

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

guitool..cmd

指定在Tools调用 git-gui [1] 菜单的相应项时执行的 shell 命令行。每个工具都必须使用此选项。该命令从工作目录的根目录开始执行,并且在环境中它接收工具GIT_GUITOOL的名称,当前选择的文件FILENAME的名称为,当前分支的名称为CUR_BRANCH(如果头已分离,CUR_BRANCH则为空)。

guitool..needsFile

只有在 GUI 中选择差异时才运行该工具。它保证FILENAME不是空的。

guitool..noConsole

以静默方式运行该命令,而不创建窗口来显示其输出。

guitool..noRescan

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

guitool..confirm

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

guitool..argPrompt

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

guitool..revPrompt

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

guitool..revUnmerged

仅显示子revPrompt对话框中的未合并分支。这对类似于合并或重新绑定的工具很有用,但不适用于结帐或重置等工具。

guitool..title

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

guitool..prompt

argPrompt和之前的小节前面指定要显示在对话框顶部的常规提示字符串revPrompt。默认值包括实际的命令。

help.browser

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

help.format

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

help.autoCorrect

在等待给定的十分之一秒(0.1秒)后,自动纠正并执行错误输入的命令。如果可以从输入的文本中推断出多个命令,则不执行任何操作。如果此选项的值为负数,则会立即执行更正的命令。如果该值为0 - 该命令将仅显示但不执行。这是默认设置。

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]。这可以在每个远程的基础上被覆盖; 请参阅remote。 .proxy

http.proxyAuthMethod

设置对 HTTP 代理进行身份验证的方法。这只有在配置的代理字符串包含用户名部分(即具有表格user@hostuser@host:port)的情况下才会生效。这可以在每个远程的基础上被覆盖; 见remote..proxyAuthMethod。两者都可以被GIT_HTTP_PROXY_AUTHMETHOD环境变量覆盖。可能的值是:

  • anyauth- 自动选择合适的认证方法。假设代理使用407状态代码和一个或多个具有支持的认证方法的代理认证头来回答未经身份验证的请求。这是默认设置。

  • basic- HTTP基本认证

  • digest- HTTP摘要认证; 这可以防止密码以明文形式传输到代理服务器

  • negotiate- GSS协商认证(比较 - 协商选项curl(1)

  • ntlm- NTLM身份验证(比较--ntlm选项curl(1)

http.emptyAuth

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

http.delegation

控制 GSSAPI 凭据委派。从版本7.21.7开始,代理在libcurl中默认处于禁用状态。设置参数以告诉服务器当涉及到用户凭证时允许委派什么。与GSS / Kerberos一起使用。可能的值是:

  • none- 不允许任何代表团。

  • policy- 当且仅当在Kerberos服务票据中设置了OK-AS-DELEGATE标志时才委派,这是领域策略的问题。

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

http.extraHeader

与服务器通信时传递额外的 HTTP 标头。如果存在多个这样的条目,则将它们全部添加为额外的标题。要允许覆盖从系统配置继承的设置,一个空值会将额外的标题重置为空列表。

http.cookieFile

包含先前存储的 cookie 行的文件的路径名,如果它们与服务器匹配,则应该在Git http会话中使用该行。从中读取 cookie 的文件的文件格式应该是普通的HTTP头文件或Netscape / Mozilla的 cookie 文件格式(请参阅参考资料curl(1))。请注意,除非设置了http.saveCookies,否则使用http.cookieFile指定的文件仅用作输入。

http.saveCookies

如果设置,则将请求期间收到的 cookie 存储到由 http.cookieFile 指定的文件中。如果 http.cookieFile 未设置,则不起作用。

http.sslVersion

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

  • sslv2

  • sslv3

  • tlsv1

  • tlsv1.0

  • tlsv1.1

  • tlsv1.2

可以被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 时是否验证 SSL 证书。可以被GIT_SSL_NO_VERIFY环境变量覆盖。

http.sslCert

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

http.sslKey

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

http.sslCertPasswordProtected

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

http.sslCAInfo

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

http.sslCAPath

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

http.pinnedpubkey

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

http.sslTry

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

http.maxRequests

并行启动多少个HTTP请求。可以被GIT_HTTP_MAX_REQUESTS环境变量覆盖。缺省值是5。

http.minSessions

请求中保留的卷发会话数(跨槽计数)。在调用http_cleanup()之前,它们不会以curl_easy_cleanup()结束。如果未定义USE_CURL_MULTI,则此值将被限制为1.默认为1。

http.postBuffer

将数据发布到远程系统时,智能HTTP传输所使用的缓冲区的最大大小(以字节为单位)。对于大于此缓冲区大小的请求,使用HTTP / 1.1和Transfer-Encoding:chunked来避免在本地创建大量的包文件。默认值是1 MiB,这对大多数请求来说已经足够了。

http.lowSpeedLimit, http.lowSpeedTime

如果HTTP传输速度小于http.lowSpeedLimit用于长于http.lowSpeedTime秒,传送被中止。可以通过覆盖GIT_HTTP_LOW_SPEED_LIMITGIT_HTTP_LOW_SPEED_TIME环境变量。

http.noEPSV

通过curl禁止使用EPSV ftp命令的布尔值。这对于一些不支持EPSV模式的“差”ftp服务器可能会有所帮助。可以被GIT_CURL_FTP_NO_EPSV环境变量覆盖。默认值为false(卷曲将使用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..*

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

  1. Scheme(例如,httpsinhttps://example.com/)。该字段必须与配置密钥和URL完全匹配。

  2. 主机/域名(例如,example.cominhttps://example.com/)。该字段必须在配置密钥和URL之间匹配。可以*将主机名的一部分指定为匹配此级别的所有子域。https://*.example.com/例如会匹配https://foo.example.com/,但不会https://foo.bar.example.com/

  3. 端口号(例如,8080inhttp://example.com:8080/)。该字段必须与配置密钥和URL完全匹配。匹配前,省略的端口号会自动转换为方案的正确默认值。

  4. 路径(例如,repo.gitinhttps://example.com/repo.git)。配置密钥的路径字段必须与URL的路径字段完全匹配或作为以斜杠分隔的路径元素的前缀。这意味着具有路径foo/匹配URL路径的配置密钥foo/bar。前缀只能匹配斜线(/)边界。较长的匹配优先(因此,带路径的配置键与foo/barURL路径的匹配性好于foo/bar仅带路径的配置键foo/)。

  5. 用户名(例如,userinhttps://user@example.com/repo.git)。如果配置密钥具有用户名,则它必须完全匹配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 都不参与匹配。

ssh.variant

取决于环境变量的值GIT_SSHGIT_SSH_COMMAND,或配置设置core.sshCommand,GIT 中自动检测是否需要调整其命令行参数用于与PLINK 或使用的 TortoisePlink,而不是默认值(的OpenSSH)。

配置变量ssh.variant可以设置为覆盖此自动检测; 有效值为sshplinkputtytortoiseplink。任何其他值将被视为正常的ssh。该设置可以通过环境变量覆盖GIT_SSH_VARIANT

i18n.commitEncoding

编码提交消息的字符存储在; Git 本身并不在乎,但是这些信息是必要的,例如从电子邮件或 gitk 图形历史浏览器(可能在将来其他地方或其他porcelains中)导入提交时。参见例如 git-mailinfo [1]。默认为utf-8

i18n.logOutputEncoding

编码提交消息的字符将转换为运行时git log和朋友。

imap

imap节中的配置变量在 git-imap-send [1] 中进行了描述。

index.version

指定用于初始化新索引文件的版本。这不会影响现有的存储库。

init.templateDir

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

instaweb.browser

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

instaweb.httpd

HTTP daemon 命令行在您的工作存储库上启动 gitweb。参见 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

在交互式命令中,允许用户使用单个键提供单字母输入(即不输入)。目前,这被--patchgit-add [1],git-checkout [1],git-commit [1],git-reset [1 ]和 git-stash [1]使用。请注意,如果便携式按键输入不可用,则此设置将被忽略; 需要Perl模块Term :: ReadKey。

interactive.diffFilter

当一个交互式命令(比如git add --patch)显示一个彩色差异时,git 会通过由该配置变量定义的shell命令来传递 diff。该命令可以进一步标记用于人类消费的差异,前提是它保留与原始差异中的行的一一对应关系。默认为禁用(不过滤)。

log.abbrevCommit

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

log.date

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

log.decorate

打印 log 命令显示的任何提交的 ref 名称。如果short被指定,裁判名称前缀refs/heads/refs/tags/并且refs/remotes/将不被打印。如果full指定,将打印完整的参考名称(包括前缀)。如果auto被指定,那么如果输出到达终端,则 ref 名称显示为如果short给定,否则不显示 ref 名称。这与--decorate选项相同git log

log.follow

如果truegit log将作为如果--follow当单个在给定的使用选项。这与它具有相同的限制--follow,即它不能用于跟踪多个文件,并且在非线性历史记录上不能很好地工作。

log.graphColors

以逗号分隔的颜色列表,可用于绘制历史线条git log --graph

log.showRoot

如果为 true,则初始提交将显示为一个大创建事件。这相当于针对空树的差异。诸如 git-log [1] 或 git-whatchanged [1] 之类的工具通常会隐藏根提交,现在将显示它。默认情况下为真。

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

mailinfo.scissors

如果为 true,默认情况下会使 git-mailinfo [1](因此git-am [1])起作用,就像在命令行上提供了--scissors选项一样。激活时,此功能可在剪刀线(即主要由“> 8”,“8”和“ - ”)组成的剪刀线之前移除消息体中的所有内容。

mailmap.file

扩充邮件地图文件的位置。位于存储库根目录中的默认邮件地图首先被加载,然后被加载,然后被该变量指向的邮件地图文件。邮件地图文件的位置可能位于存储库子目录中,或者位于存储库本身之外的某个位置。参见 git-shortlog [1]和git-blame [1]。

mailmap.blob

就像mailmap.file,但是将该值视为对存储库中 blob 的引用。如果两个mailmap.filemailmap.blob给出,两者都分析,从项目mailmap.file采取优先次序。在裸仓库中,默认为HEAD:.mailmap。在非裸仓库中,它默认为空。

man.viewer

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

man..cmd

指定命令来调用指定的 man 查看器。指定的命令在shell中使用作为参数传递的手册页进行评估。(请参阅git-help [1]。)

man..path

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

merge.conflictStyle

指定在合并时将冲突的区块写入工作树文件的样式。默认值是“合并”,它显示了一个<<<<<<<冲突标记,一侧=======发生的变化,一个标记,另一侧发生的变化,然后是>>>>>>>标记。另一种样式“diff3”在|||||||标记之前添加了一个标记和原始文本=======

merge.defaultToUpstream

如果在没有任何提交参数的情况下调用合并,则使用存储在其远程跟踪分支中的上次观察值合并为当前分支配置的上游分支。查询branch..merge名称为远程命名的远程分支的值branch..remote,然后将它们映射remote..fetch到其对应的远程跟踪分支,并合并这些跟踪分支的提示。

merge.ff

默认情况下,Git 在合并作为当前提交的后代的提交时不会创建额外的合并提交。相反,当前分支的尖端被快速转发。当设置为false,这个变量告诉Git在这种情况下创建一个额外的合并提交(相当于--no-ff从命令行提供选项)。设置only为时,只允许进行这种快进合并(相当于--ff-only从命令行提供选项)。

merge.branchdesc

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

merge.log

除了分支名称之外,还可以在日志消息中最多填写指定数量的来自要合并的实际提交的单行描述。默认为 false,true 为20的同义词。

merge.renameLimit

在合并期间执行重命名检测时要考虑的文件数量; 如果未指定,则默认为 diff.renameLimit 的值。

merge.renormalize

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

merge.stat

是否在合并结束时在 ORIG_HEAD 和合并结果之间打印 diffstat。默认情况下为真。

merge.tool

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

  • araxis

  • bc

  • bc3

  • codecompare

  • deltawalker

  • diffmerge

  • diffuse

  • ecmerge

  • emerge

  • examdiff

  • gvimdiff

  • gvimdiff2

  • gvimdiff3

  • kdiff3

  • meld

  • opendiff

  • p4merge

  • tkdiff

  • tortoisemerge

  • vimdiff

  • vimdiff2

  • vimdiff3

  • winmerge

  • xxdiff

merge.verbosity

控制递归合并策略显示的输出量。如果检测到冲突,级别0只输出最终的错误消息。1级只输出冲突,2个输出冲突和文件更改。5级及以上输出调试信息。缺省值是2级。可以由GIT_MERGE_VERBOSITY环境变量覆盖。

merge..name

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

merge..driver

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

merge..recursive

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

mergetool..path

覆盖给定工具的路径。如果您的工具不在 PATH 中,这非常有用。

mergetool..cmd

指定命令来调用指定的合并工具。在 shell 中使用以下可用变量评估指定的命令:BASE是包含要合并的文件的公共基础的临时文件的名称(如果可用);LOCAL是包含当前分支上文件内容的临时文件的名称;REMOTE是包含来自合并分支的文件内容的临时文件的名称;MERGED包含合并工具应将写入成功合并结果的文件的名称。

mergetool..trustExitCode

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

mergetool.meld.hasOutput

旧版本meld不支持该--output选项。Git 会尝试通过检查输出来检测是否meld支持。配置将使 Git 跳过这些检查并改为使用配置的值。设置要告诉 Git 的无条件使用选项,使用避免。--outputmeld --helpmergetool.meld.hasOutputmergetool.meld.hasOutputtrue--outputfalse--output

mergetool.keepBackup

在执行合并之后,具有冲突标记的原始文件可以保存为具有.orig扩展名的文件。如果这个变量被设置为false那么这个文件不会被保留。默认为true(即保留备份文件)。

mergetool.keepTemporaries

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

mergetool.writeToTemp

Git 的写入临时BASELOCAL以及REMOTE默认的文件冲突的版本在worktree。设置时,Git 会尝试使用这些文件的临时目录true。默认为false

mergetool.prompt

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

notes.mergeStrategy

解决笔记冲突时默认选择哪种合并策略。必须是一manualourstheirsunion,或cat_sort_uniq。默认为manual。有关每种策略的更多信息,请参阅 git-notes [1]的“注释合并策略”部分。

notes..mergeStrategy

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

notes.displayRef

显示提交消息时显示备注的(完全限定)refname。这个变量的值可以设置为一个 glob,在这种情况下,所有匹配的ref都会显示出来。您也可以多次指定此配置变量。对于不存在的 ref,将发出警告,但不匹配任何 ref 的 glob 默默无视。

该设置可以用GIT_NOTES_DISPLAY_REF环境变量覆盖,该变量必须是以冒号分隔的参考或球体列表。

“core.notesRef”的有效值(可能被 GIT_NOTES_REF 覆盖)也隐式添加到要显示的 ref 列表中。

notes.rewrite.

当用(当前amend或者rebase)重写提交并且该变量被设置true为时,Git会自动将笔记从原始文件复制到重写的提交中。默认为true,但请参阅下面的“notes.rewriteRef”。

notes.rewriteMode

在重写过程中复制笔记时(请参阅“notes.rewrite。”选项),确定如果目标提交已经有笔记要执行的操作。必须是一个overwriteconcatenatecat_sort_uniq,或ignore。默认为concatenate

该设置可以用GIT_NOTES_REWRITE_MODE环境变量覆盖。

notes.rewriteRef

在重写过程中复制备注时,指定应该复制其备注的(完全限定)参考。ref 可以是一个 glob,在这种情况下,所有匹配参考中的备注都将被复制。您也可以多次指定此配置。

没有默认值; 您必须配置此变量以启用音符重写。将其设置refs/notes/commits为启用默认提交备注的重写。

该设置可以用GIT_NOTES_REWRITE_REF环境变量覆盖,该变量必须是以冒号分隔的参考或球体列表。

pack.window

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

pack.depth

当命令行没有给出最大深度时,git-pack-objects [1] 使用的最大增量深度。默认为50。

pack.windowMemory

在命令行中未给出限制时,包装窗口内存的 git-pack-objects [1] 中的每个线程占用的最大内存大小。该值可以后缀“k”,“m”或“g”。当未配置(或明确设置为0)时,不会有任何限制。

pack.compression

一个整数-1..9,表示包文件中对象的压缩级别。-1是zlib的默认值。0代表没有压缩,1..9代表不同的速度/尺寸折衷,9代表最慢。如果未设置,则默认为 core.compression。如果没有设置,默认为-1,默认为zlib,这是“速度和压缩之间的默认折衷(当前等同于级别6)”。

请注意,更改压缩级别不会自动重新压缩所有现有对象。您可以通过将-F选项传递给 git-repack [1] 来强制再压缩。

pack.deltaCacheSize

用于缓存 git-pack-objects [1] 中的增量的最大内存(以字节为单位),然后将它们写出到一个包中。该缓存用于加速写入对象阶段,因为一旦找到所有对象的最佳匹配,就不必重新计算最终的增量结果。在内存紧张的机器上重新包装大型软件仓库可能会受到严重影响,特别是如果此缓存将系统推入交换。值为0意味着没有限制。1字节的最小尺寸可以用于虚拟地禁用该缓存。默认为256 MiB。

pack.deltaCacheLimit

增量的最大大小,即缓存在 git-pack-objects [1] 中。该缓存用于加速写入对象阶段,因为一旦找到所有对象的最佳匹配,就不必重新计算最终的增量结果。默认为1000。

pack.threads

指定搜索最佳增量匹配时产生的线程数。这要求用 pthread 编译 git-pack-objects [1],否则这个选项会被忽略并带有警告。这是为了减少多处理器机器的打包时间。然而,增量搜索窗口所需的内存量乘以线程数量。指定0将导致Git自动检测CPU的数量并相应地设置线程数量。

pack.indexVersion

指定默认包装索引版本。对于1.5.2之前的 Git 版本使用的旧版包装索引,有效值为1,对于包装容量大于4 GB的新包装索引,有效值为2,并且对重新包装损坏的包装提供适当的保护。版本2是默认值。请注意,强制执行版本2,并且只要相应的包大于2 GB,就会忽略此配置选项。

如果您有一个旧的 Git 不理解版本2*.idx文件,通过非本地协议(例如“http”)克隆或获取将从另一端复制*.pack文件和相应*.idx文件的可能会给您一个无法访问的存储库与你的老版本的Git。*.pack但是,如果文件小于2 GB,则可以使用* .pack文件上的git-index-pack [1]来重新生成该*.idx文件。

pack.packSizeLimit

包的最大尺寸。此设置仅影响重新包装到文件,即 git://协议不受影响。它可以被--max-pack-sizegit-repack [1]选项覆盖。达到此限制会导致创建多个包装文件; 这反过来又防止了位图的创建。允许的最小尺寸限制为1 MiB。默认值是无限的。常见的单元后缀kmg支持。

pack.useBitmaps

如果为 true,则 git 在打包到标准输出时(例如,在获取的服务器端期间)将使用包位图(如果可用)。默认为true。除非您正在调试包位图,否则通常不需要关闭此功能。

pack.writeBitmaps (deprecated)

这是一个不赞成的同义词repack.writeBitmaps

pack.writeBitmapHashCache

如果为true,git 将在位图索引中包含一个“散列缓存”部分(如果写入的话)。这个缓存可以用来提供 git 的 delta 启发式,可能会导致位图对象和非位图对象之间更好的增量(例如,在较旧的位图包和自上次gc以来推送的对象之间提供提取时)。缺点是每个对象的磁盘空间消耗4个字节,JGi t的位图实现不理解它,如果在同一个存储库上使用 Git和JGit,会导致它投诉。默认为false。

pager.

如果值是布尔值,则在写入 tty 时打开或关闭特定 Git 子命令输出的分页。否则,使用由值的指定的寻呼机打开子命令的分页pager.。如果--paginate--no-pager在命令行上指定,则优先于此选项。要为所有命令,设置禁用分页core.pagerGIT_PAGERcat

pretty.

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

protocol.allow

如果设置,为所有没有明确规定策略的协议提供用户定义的默认策略(protocol..allow)。默认情况下,如果未设置,已知安全协议(http,https,git,ssh,文件)具有默认策略always,则已知危险协议(ext)具有默认策略never,并且所有其他协议具有默认策略user。支持的策略:

  • always- 协议总是可以使用的。

  • never- 协议永远不能使用。

  • user- 只有在GIT_PROTOCOL_FROM_USER未设置或值为1时才能使用协议。当您希望协议可以被用户直接使用但不希望被执行克隆/获取的命令使用时,应使用此策略/推命令没有用户输入,例如递归子模块初始化。

protocol..allow

使用clone / fetch / push 命令设置要由协议使用的策略。请参阅protocol.allow上面的可用政策。

git 目前使用的协议名称为:

  • file:任何本地基于文件的路径(包括file://URL或本地路径)

  • git:通过直接TCP连接(或代理,如果已配置)的匿名git协议

  • ssh:git over ssh(包括host:path语法ssh://,等)。

  • http:通过http的git,“智能http”和“哑巴http”。请注意,这not包括https; 如果你想配置两者,你必须单独做。

  • 任何外部助手都按其协议命名(例如,用于hg允许git-remote-hg助手)

pull.ff

默认情况下,Git在合并作为当前提交的后代的提交时不会创建额外的合并提交。相反,当前分支的尖端被快速转发。当设置为false,这个变量告诉Git在这种情况下创建一个额外的合并提交(相当于--no-ff从命令行提供选项)。设置only为时,只允许进行这种快进合并(相当于--ff-only从命令行提供选项)。此设置merge.ff在拔取时覆盖。

pull.rebase

如果为true,则rebase分支位于提取分支的顶部,而不是在运行“git pull”时合并默认分支和默认分支。请参阅“分支。<名称> .rebase”以每个分支为基础进行设置。

当保存时,也会传递--preserve-merges到,git rebase以便本地提交的合并提交不会因运行而变得平坦git pull

当值为时interactive,rebase 以交互模式运行。

注意:这是一个可能危险的操作; ,不要用它除非你理解的含义才能使用(请查看git-变基[1]了解详细信息)。

pull.octopus

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

pull.twohead

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

push.default

定义git push如果没有明确给出 refspec 就应该采取的行动。不同的值非常适合特定的工作流程; 例如,在一个纯粹的中央工作流程(即提取源等于推送目的地),upstream可能是你想要的。可能的值是:

  • nothing- 除非明确给出refspec,否则不要推送任何东西(错误输出)。这主要是针对那些想要通过始终明确避免错误的人。

  • current- 推送当前分支以更新接收端具有相同名称的分支。适用于中央和非中央工作流程。

  • upstream- 将当前分支推回到其更改通常集成到当前分支(称为@{upstream})的分支中。这种模式只有在您推送到您通常需要的同一个存储库(例如中央工作流程)时才有意义。

  • tracking- 这是一个不赞成的同义词upstream

  • simple- 在集中式工作流程中,upstream如果上游分支的名称与本地名称不同,则可以像增加安全性一样拒绝推送。当推送到与通常从中拉出的远程不同的远程时,按照current。这是最安全的选择,适合初学者。该模式已成为Git 2.0中的默认模式。

  • matching- 推送两端同名的所有分支。这使得你正在推动记住设置将要推出的分支(例如,如果你总是推存储库maintmaster有其他分支机构,你推到会有这两个分支的库,和当地的maintmaster将在那里推)。要有效地使用这种模式,你必须确保all你推出的分支在运行之前已经准备好被推出git push,因为这种模式的重点在于让您一次推送所有分支。如果您通常只完成一个分支的工作并推出结果,而其他分支未完成,则此模式不适合您。此外,此模式不适合推入共享的中央存储库,因为其他人可能会在该处添加新的分支,或者更新您的控制之外的现有分支的提示。这曾经是默认的,但从Git 2.0开始(这simple是新的默认设置)。

push.followTags

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

push.gpgSign

可能被设置为布尔值或字符串if-asked。一个真正的值会导致所有推送被GPG签名,就好像--signed被传递给 git-push [1]一样。if-asked如果服务器支持该字符串,该字符串将导致推送被签名,就像--signed=if-asked传递给它一样git push。假值可能会覆盖来自低优先级配置文件的值。一个明确的命令行标志总是会覆盖这个配置选项。

push.recurseSubmodules

确保远程跟踪分支上提供了要推送的修订版所使用的所有子模块提交。如果该值是checkGit,那么 Git 将验证所有要修改的子模块提交在子模块的至少一个远程模块上可用。如果任何提交丢失,推送将被中止并以非零状态退出。如果该值是,on-demand那么将推送修订中要更改的所有子模块。如果按需无法推送所有必需的修订,它也会被中止并以非零状态退出。如果该值no是保留推送时忽略子模块的默认行为。您可以在推送时通过指定覆盖此配置--recurse-submodules=check|on-demand|no

rebase.stat

是否显示自上次变基期以来上游变化的差异。默认为 False。

rebase.autoSquash

如果--autosquash默认设置为 true 启用选项。

rebase.autoStash

设置为 true 时,在操作开始之前自动创建临时存储条目,并在操作结束后应用它。这意味着你可以在肮脏的工作树上运行 rebase。但是,谨慎使用:成功重新绑定后的最终隐藏应用程序可能会导致不平凡的冲突。默认为 false。

rebase.missingCommitsCheck

如果设置为“警告”,git rebase -i 将在一些提交被删除时(例如,一行被删除)打印警告,但是 rebase 仍然会继续。如果设置为“错误”,它将打印先前的警告并停止重设,git rebase --edit-todo然后可用于纠正错误。如果设置为“忽略”,则不进行检查。要删除没有警告或错误的提交,请使用drop待办事项列表中的命令。默认为“忽略”。

rebase.instructionFormat

格式字符串,如 git-log [1] 中所指定的,用于交互式重新绑定期间的指令列表。该格式将自动具有格式前面的长提交哈希。

receive.advertiseAtomic

默认情况下,git-receive-pack 会向其客户端通告原子推送功能。如果您不想公布此功能,请将此变量设置为 false。

receive.advertisePushOptions

当设置为 true 时,git-receive-pack 会将推送选项功能通告给它的客户端。默认为 False。

receive.autogc

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

receive.certNonceSeed

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

receive.certNonceSlop

git push --signed发送一个推送证书时,这个推送证书由在此数秒钟内为同一个存储库提供服务的接收包发布的“随机数”,将证书中发现的“随机数”导出GIT_PUSH_CERT_NONCE到挂钩(而不是接收包问包括发送方)。这可能允许写入检查pre-receive并且post-receive更容易一些。而不是检查GIT_PUSH_CERT_NONCE_SLOP环境变量的记录是由多少秒nonce是陈旧的,以决定他们是否要接受证书,他们只能检查GIT_PUSH_CERT_NONCE_STATUSOK

receive.fsckObjects

如果它设置为 true,git-receive-pack 将检查所有收到的对象。如果格式错误的对象或链接断开,它将中止。中止的结果只是悬挂的对象。默认为 false。如果未设置,transfer.fsckObjects则使用其值。

receive.fsck.

receive.fsckObjects被设置为 true 时,误差可以通过配置切换到警告,反之亦然receive.fsck.设置其中是 fsck 的消息ID和值为之一errorwarnignore。为了方便起见,fsck在错误/警告前添加了消息ID,例如“missingEmail:invalid author / committer line - missing email”意味着该设置receive.fsck.missingEmail = ignore将隐藏该问题。

此功能旨在支持使用传统存储库时不会推送时间receive.fsckObjects = true,允许主机接受存在某些已知问题但仍捕获其他问题的存储库。

receive.fsck.skipList

已知以非致命方式破坏的对象名称的排序列表(即每行一个SHA-1)的路径应被忽略。如果尽早提交包含可安全忽略的错误(如无效的提交者电子邮件地址)的应用程序,则应接受已建立的项目,此功能非常有用。注意:使用此设置不能跳过损坏的对象。

receive.keepAlive

从客户端收到包后,在处理包时receive-pack可能没有输出(如果--quiet指定),导致某些网络断开 TCP 连接。通过设置此选项,如果receive-pack在此阶段中不传输任何数据达receive.keepAlive数秒钟,它将发送一个短保持数据包。默认值是5秒; 设置为0将完全禁用Keepalive。

receive.unpackLimit

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

receive.maxInputSize

如果传入包的大小大于此限制,那么 git-receive-pack 将会出错,而不是接受包文件。如果没有设置或设置为0,那么大小是无限的。

receive.denyDeletes

如果设置为 true,git-receive-pack 将拒绝删除 ref 的 ref更新。使用它来防止通过推送删除这样的引用。

receive.denyDeleteCurrent

如果设置为 true,那么 git-receive-pack 将拒绝一个 ref更新,它会删除非裸仓库的当前检出分支。

receive.denyCurrentBranch

如果设置为 true 或“拒绝”,git-receive-pack将拒绝对非裸仓库的当前签出分支的 ref更新。这样的推送是潜在的危险,因为它会使HEAD 与索引和工作树不同步。如果设置为“警告”,则将这种推送警告打印到标语,但允许推送继续。如果设置为 false 或“忽略”,则允许在没有消息的情况下推送。默认为“拒绝”。

另一种选择是“updateInstead”,如果推入当前分支,它将更新工作树。此选项用于同步工作目录,当通过交互式 ssh 无法轻松访问一个工作目录时(例如实时网站,因此要求工作目录清洁)。在虚拟机内部进行开发以在不同的操作系统上测试和修复代码时,此模式也会派上用场。

默认情况下,如果工作树或索引与 HEAD 有任何不同,“updateInstead”将拒绝推送,但push-to-checkout可以使用挂钩来自定义此操作。见githooks [5]。

receive.denyNonFastForwards

如果设置为 true,那么 git-receive-pack 会拒绝不是快进的 ref 更新。即使强制推送,也可以通过推送来阻止这种更新。该配置变量在初始化共享存储库时设置。

receive.hideRefs

这个变量是相同的transfer.hideRefs,但只适用于receive-pack(并且因此影响推送,但不提取)。尝试更新或删除隐藏参考git push被拒绝。

receive.updateServerInfo

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

receive.shallowUpdate

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

remote.pushDefault

遥控器默认为推送。覆盖branch..remote所有分支,并由branch..pushRemote特定分支覆盖。

remote..url

远程存储库的 URL。请参阅git-fetch [1]或git-push [1]。

remote..pushurl

远程存储库的推送网址。见 git-push [1]。

remote..proxy

对于需要 curl(http,https和ftp)的遥控器,用于该遥控器的代理的URL。设置为空字符串以禁用该远程代理。

remote..proxyAuthMethod

对于需要 curl(http,https和ftp)的遥控器,用于对正在使用的代理(可能设置remote..proxy)进行认证的方法。看http.proxyAuthMethod

remote..fetch

git-fetch [1]的默认设置“refspec”。参见git-fetch [1]。

remote..push

git-push [1]的默认设置“refspec”。见git-push [1]。

remote..mirror

如果为 true,则推送到此远程将自动运行,就像--mirror在命令行上给出选项一样。

remote..skipDefaultUpdate

如果为 true,那么当使用 git-fetch [1] 或updategit-remote [1] 的子命令进行更新时,该远程将默认跳过。

remote..skipFetchAll

如果为 true,那么当使用 git-fetch [1] 或updategit-remote [1] 的子命令进行更新时,该远程将默认跳过。

remote..receivepack

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

remote..uploadpack

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

remote..tagOpt

如果将此值设置为 --no-tags,则从远程<名称>获取时将禁用自动标记跟踪。将它设置为 --tags 将从远程中获取每个标记,即使它们不能从远程分支头到达。将这些标志直接传递给 git-fetch [1] 可以覆盖此设置。查看选项--tags 和 --no-tags的git-fetch [1]。

remote..vcs

将其设置为值将使 Git 通过 git-remote- helper与远程进行交互。

remote..prune

设置为 true 时,默认从此远程访存将删除远程中不再存在的任何远程跟踪引用(就像--prune在命令行上给出该选项一样)。覆盖fetch.prune设置,如果有的话。

remotes.

由“git remote update ”获取的遥控器列表。见 git-remote [1]。

repack.useDeltaBaseOffset

默认情况下,git-repack [1]创建使用 delta-base 偏移量的包。如果您需要使用比版本1.4.4更高的 Git 来共享您的存储库,请直接或通过诸如 http 之类的哑协议来共享您的存储库,那么您需要将此选项设置为“false”并重新打包。通过本地协议从旧的Git版本访问不受此选项的影响。

repack.packKeptObjects

如果设置为 true,则git repack表示好像--pack-kept-objects已通过。有关详细信息,请参阅 git-repack [1]。默认为false正常,但是true如果正在写入位图索引(通过--write-bitmap-indexrepack.writeBitmaps)。

repack.writeBitmaps

如果为 true,git会在将所有对象打包到磁盘时写入一个位图索引(例如,当git repack -a运行时)。此索引可以加速为克隆和提取创建的后续包的“计数对象”阶段,但需要花费一些磁盘空间和花费在初始重新包装上的额外时间。如果创建多个包文件,这不起作用。默认为false。

rerere.autoUpdate

设置为 true 时,git-rerere使用先前记录的分辨率干净地解决冲突后,使用结果内容更新索引。默认为 false。

rerere.enabled

激活已解决冲突的记录,以便相同的冲突块可以自动解决,如果再次遇到冲突块。默认情况下,如果在该rr-cache目录下有一个目录,则启用 git-rerere [1]$GIT_DIR,例如,如果以前在资源库中使用了“rerere”。

sendemail.identity

配置标识。给出时,导致sendemail.sendemail部分中的值优先于部分中的值。默认标识是的值sendemail.identity

sendemail.smtpEncryption

有关说明,请参阅 git-send-email [1]。请注意,此设置不受该identity机制的约束。

sendemail.smtpssl (deprecated)

sendemail.smtpEncryption = ssl已弃用的别名。

sendemail.smtpsslcertpath

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

sendemail..*

sendemail.*通过命令行或命令行选择的身份特定版本的参数优先于选择此身份的参数sendemail.identity

sendemail.aliasesFile sendemail.aliasFileType sendemail.annotate sendemail.bcc sendemail.cc sendemail.ccCmd sendemail.chainReplyTo sendemail.confirm sendemail.envelopeSender sendemail.from sendemail.multiEdit sendemail.signedoffbycc sendemail.smtpPass sendemail.suppresscc sendemail.suppressFrom sendemail.to sendemail.smtpDomain sendemail.smtpServer sendemail.smtpServerPort sendemail.smtpServerOption sendemail.smtpUser sendemail.thread sendemail.transferEncoding sendemail.validate sendemail.xmailer

有关说明,请参阅git-send-email [1]。

sendemail.signedoffcc(已弃用)

endemail.signedoffbycc已弃用的别名。

sendemail.smtpBatchSize

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

sendemail.smtpReloginDelay

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

showbranch.default

git-show-branch [1]的默认分支集合。参见git-show-branch [1]。

splitIndex.maxPercentChange

使用拆分索引功能时,这将指定拆分索引可以包含的条目的百分比,与写入新共享索引之前拆分索引和共享索引中的条目总数相比。值应该介于0和100之间。如果值为0,则总是写入新的共享索引,如果为100,则永远不会写入新的共享索引。默认情况下,该值为20,因此如果分割索引中的条目数大于条目总数的20%,则会写入新的共享索引。参见git-update-index [1]。

splitIndex.sharedIndexExpire

使用拆分索引功能时,自从该变量指定时间以来未修改的共享索引文件将在创建新的共享索引文件时被删除。值“now”立即使所有条目到期,并且“never”完全禁止到期。默认值是“2.weeks.ago”。请注意,每次基于它创建或读取新的分割索引文件时,都会将共享索引文件修改(用于过期)。参见 git-update-index [1]。

status.relativePaths

默认情况下,git-status [1]显示相对于当前目录的路径。设置此变量以false显示相对于存储库根目录的路径(这是v1.5.4之前的Git的默认值)。

status.short

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

status.branch

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

status.displayCommentPrefix

如果设置为 true,git 的状态[1]将插入每条输出线之前注释前缀(开始core.commentChar,即#由默认值)。这是 Git 1.8.4和之前的 git-status [1]的行为。默认为 false。

status.showStash

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

status.showUntrackedFiles

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

  • no- 不显示未跟踪的文件。

  • normal- 显示未跟踪的文件和目录。

  • all- 显示未跟踪目录中的单个文件。

如果未指定此变量,则默认为normal。这个变量可以用 git-status [1]和git-commit [1] 的 -u | --untracked-files选项覆盖。

status.submoduleSummary

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

stash.showPatch

如果设置为true,则git stash show没有选项的命令将以补丁形式显示隐藏条目。默认为false。请参阅showgit-stash [1]中的命令说明。

stash.showStat

如果设置为true,则git stash show没有选项的命令将显示存储条目的diffstat。默认为true。请参阅showgit-stash [1]中的命令说明。

submodule..url

子模块的 URL。这个变量通过 .gitmodules 文件复制到 git configgit submodule init。用户可以在通过获取子模块之前更改配置的 URLgit submodule update。如果子模块 .active 或submodule.active 都未设置,则将此变量的存在用作后备,以指示子模块是否对 git 命令感兴趣。有关详细信息,请参阅 git-submodule [1]和gitmodules [5]。

submodule..update

子模块的默认更新过程。该变量由git submodule initgitmodules [5]文件填充。请参阅updategit-submodule [1]中的命令说明。

submodule..branch

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

submodule..fetchRecurseSubmodules

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

submodule..ignore

定义在什么情况下,“git status”和 diff 系列显示已修改的子模块。当设置为“全部”时,它永远不会被视为已修改(但它仍会显示在状态的输出中,并在已执行时进行提交),“脏”将忽略对子模块工作树的所有更改,并且只会带来差异考虑子模块的 HEAD 和超级项目中记录的提交之间的关系。“未跟踪”还会让子模块在工作树中显示修改过的跟踪文件。使用“none”(未设置此选项时的默认值)还显示在更改后的工作树中未追踪文件的子模块。此设置将覆盖此子模块的 .gitmodules 中的任何设置,两个设置都可以在命令行上使用“git submodule命令不受此设置的影响。

submodule..active

指示子模块是否对git命令感兴趣的布尔值。此配置选项优先于 submodule.active 配置选项。

submodule.active

重复字段,其中包含一个用于匹配子模块路径的 pathspec,以确定子模块是否对 git 命令感兴趣。

submodule.recurse

指定默认情况下,命令是否递归到子模块中。这适用于所有有--recurse-submodules选项的命令。默认为 false。

submodule.fetchJobs

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

submodule.alternateLocation

指定克隆子模块时子模块如何获得替代。可能的值是nosuperproject。默认情况下no,假定不添加引用。当该值设置为superproject要克隆的子模块时,计算其相对于超级项目替代项的替代位置。

submodule.alternateErrorStrategy

指定如何通过经由计算得到的子模块的交替来处理错误submodule.alternateLocation。可能的值是ignoreinfodie。默认是die

tag.forceSignAnnotated

一个布尔值,指定创建的带注释的标签是否应该由GPG签名。如果--annotate在命令行中指定,则优先于此选项。

tag.sort

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

tar.umask

这个变量可以用来限制tar归档项的权限位。默认值是0002,这将关闭世界写入位。特殊值“user”表示将使用归档用户的umask。请参阅umask(2)和git-archive [1]。

transfer.fsckObjects

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

transfer.hideRefs

字符串receive-packupload-pack用于决定哪些引用从他们的初始广告中省略。使用多个定义来指定多个前缀字符串。排除了此变量的值中列出的层次结构下的 ref,并在响应git push或时隐藏git fetch。见receive.hideRefsuploadpack.hideRefs此配置的具体方案版本。

您也可以!在ref名称的前面添加一个否定条目,并将其明确地公开,即使先前的条目将其标记为隐藏。如果您有多个 hideRefs 值,则稍后的条目会覆盖较早的条目(并且更具体的配置文件中的条目会覆盖较不特定的条目)。

如果正在使用命名空间,则在与transfer.hiderefs模式匹配之前,命名空间前缀会从每个引用中剥离。例如,如果refs/heads/master在中指定transfer.hideRefs并且当前命名空间是foo,则refs/namespaces/foo/refs/heads/master在广告中将被省略,refs/heads/master并且refs/namespaces/bar/refs/heads/master仍然被广告为所谓的“有”行。为了在裁剪之前匹配裁判^,请在裁判名称前添加一个裁判。如果合并!^!必须先指定。

即使你隐藏了引用,客户仍然可以通过 gitnamespaces [7] 手册页的“安全”部分描述的技术窃取目标对象; 最好将私人数据保存在单独的存储库中。

transfer.unpackLimit

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

uploadarchive.allowUnreachable

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

uploadpack.hideRefs

这个变量是相同的transfer.hideRefs,但只适用于upload-pack(并且因此只影响提取,不推进)。尝试获取隐藏参考git fetch将失败。另见uploadpack.allowTipSHA1InWant

uploadpack.allowTipSHA1InWant

uploadpack.hideRefs有效时,允许upload-pack接受一个提取请求,要求在隐藏参考的顶端提供一个对象(默认情况下,这样的请求被拒绝)。另见uploadpack.hideRefs。即使这是错误的,客户端也可以通过gitnamespaces [7]手册页的“安全”部分中描述的技术窃取对象; 最好将私人数据保存在单独的存储库中。

uploadpack.allowReachableSHA1InWant

允许upload-pack接受一个提取请求,要求提供可从任何参考提示中获得的对象。但是,请注意,计算对象可达性的计算成本很高。默认为false。即使这是错误的,客户端也可以通过gitnamespaces [7]手册页的“安全”部分中描述的技术窃取对象; 最好将私人数据保存在单独的存储库中。

uploadpack.allowAnySHA1InWant

允许upload-pack接受请求任何对象的获取请求。默认为false

uploadpack.keepAlive

何时upload-pack开始pack-objects,在pack-objects准备包装时可能会有一段安静的时间。通常情况下,它会输出进度信息,但如果--quiet用于提取,pack-objects则在包数据开始之前不会输出任何内容。有些客户和网络可能会认为服务器被挂起并放弃。设置此选项将指示upload-pack每隔uploadpack.keepAlive几秒发送一个空的Keepalive数据包。将此选项设置为0将完全禁用 Keepalive 数据包。默认值是5秒。

uploadpack.packObjectsHook

如果设置了此选项,upload-pack则将运行时git pack-objects为客户端创建一个packfile,它将运行此shell命令。pack-objects它所would运行的命令和参数(包括git pack-objects开始处)被附加到shell命令中。挂钩的stdin和stdout被视为pack-objects自己运行。也就是说,upload-pack将喂入用于pack-objects钩子的输入,并期望在stdout上完成一个包文件。

请注意,如果在配置库级配置中看到此配置变量(这是针对从不受信任的存储库中获取的安全措施),则忽略此配置变量。

url..insteadOf

任何以此值开头的URL都将被重写为启动,而。如果某个站点提供大量存储库并以多种访问方式提供服务,并且某些用户需要使用不同的访问方法,则此功能允许用户指定任何等效的 URL 并让 Git 自动将 URL 重写为对于特定用户来说,这是最好的选择,即使对于网站上从未见过的存储库也是如此。如果多个字符串匹配给定的URL,则使用最长匹配。

请注意,任何协议限制都将应用于重写的URL。如果重写将URL更改为使用自定义协议或远程助手,则可能需要调整protocol.*.allow配置以允许请求。特别是,您希望用于子模块的协议必须设置为always默认值而不是默认值user。请参阅protocol.allow上面的描述。

url..pushInsteadOf

任何以此值开头的网址都不会被推送到; 相反,它将被重写为以开始,并且生成的 URL 将被推送到。在某些站点提供大量存储库并使用多种访问方法(其中一些不允许推送)访问它们的情况下,此功能允许用户指定只能拉的 URL 并让 Git 自动使用适当的 URL 来推送,即使是在网站上一个从未见过的存储库。当多个 pushInsteadOf字符串匹配给定的 URL 时,将使用最长匹配。如果远程有明确的pushurl,Git 会忽略该远程的这个设置。

user.email

您的电子邮件地址将记录在任何新创建的提交中。可以通过覆盖GIT_AUTHOR_EMAILGIT_COMMITTER_EMAIL以及EMAIL环境变量。参见git-commit-tree [1]。

user.name

您的全名将记录在任何新创建的提交中。可以通过覆盖GIT_AUTHOR_NAMEGIT_COMMITTER_NAME环境变量。参见git-commit-tree [1]。

user.useConfigOnly

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

user.signingKey

如果在创建签名标记或提交时 git-tag [1]或 git-commit [1]没有选择您希望它自动使用的密钥,则可以使用此变量覆盖缺省选择。这个选项不变地传递给 gpg 的--local-user参数,所以你可以使用 gpg 支持的任何方法指定一个键。

versionsort.prereleaseSuffix (deprecated)

已弃用的别名versionsort.suffix。如果versionsort.suffix已设置,则忽略。

versionsort.suffix

即使在git-tag [1]中使用版本排序,具有相同基本版本但不同后缀的标记名仍然按照字典顺序排序,从而导致例如在主版本之后出现预发布标签(例如,“1.0”之后的“1.0-rc1”) 。可以指定该变量来确定具有不同后缀的标签的排序顺序。

通过在此变量中指定单个后缀,包含该后缀的任何标记名都将出现在相应的主要版本之前。例如,如果变量设置为“-rc”,则所有“1.0-rcX”标签将出现在“1.0”之前。如果指定多次(每个后缀一次),则配置中后缀的顺序将确定具有这些后缀的标记名的排序顺序。例如,如果“-pre”出现在配置中的“-rc”之前,则所有“1.0-preX”标签将在任何“1.0-rcX”标签之前列出。主释放标签相对于具有各种后缀的标签的位置可以通过指定这些其他后缀之间的空后缀来确定。例如,如果后缀“-rc”,“”,“-ck”和“-bfs”

如果多个后缀匹配相同的标记名,那么该标记名将根据标记名中最早位置开始的后缀进行排序。如果多个不同的匹配后缀从最早的位置开始,那么该标记名将根据这些后缀中最长的那个进行排序。如果它们在多个配置文件中,则不同后缀之间的排序顺序未定义。

网页浏览器

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

Previous article: Next article: