Git 中文参考（一）

原文：Git Reference 协议：CC BY-NC-SA 4.0

git

原文： git-scm.com/docs/git

名称

git - 愚蠢的内容跟踪器

概要

git [--version] [--help] [-C <path>] [-c <name>=<value>]
    [--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]
    [-p|--paginate|-P|--no-pager] [--no-replace-objects] [--bare]
    [--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>]
    [--super-prefix=<path>]
    <command> [<args>]

描述

Git 是一个快速，可扩展的分布式版本控制系统，具有异常丰富的命令集，可提供高级操作和对内部的完全访问。

参见 gittutorial [7] 开始，然后参见 giteveryday [7] 获取有用的最小命令集。 Git 用户手册有更深入的介绍。

掌握了基本概念后，您可以回到此页面了解 Git 提供的命令。您可以使用“git help command”了解有关各个 Git 命令的更多信息。 gitcli [7] 手册页概述了命令行命令语法。

可以在https://git.github.io/htmldocs/git.html查看最新 Git 文档的格式化和超链接副本。

OPTIONS

 --version 

打印 git 程序来自的 Git 套件版本。

 --help 

打印概要和最常用命令的列表。如果给出选项--all或-a，则打印所有可用命令。如果命名了 Git 命令，则此选项将显示该命令的手册页。

其他选项可用于控制手册页的显示方式。有关详细信息，请参阅 git-help [1] ，因为git --help ...内部转换为git help ...。

 -C <path> 

如同在 _< path>中启动 git 一样运行 _ 而不是当前的工作目录。当给出多个-C选项时，相对于前一个-C <path>解释每个后续的非绝对-C <path>。

此选项会影响期望路径名称的选项，如--git-dir和--work-tree，因为它们对路径名的解释将相对于-C选项导致的工作目录。例如，以下调用是等效的：

git --git-dir=a.git --work-tree=b -C c status
git --git-dir=c/a.git --work-tree=c/b status

 -c <name>=<value> 

将配置参数传递给命令。给定的值将覆盖配置文件中的值。 < name>预期格式与 git config （由点分隔的子键）列出的格式相同。

注意，允许省略git -c foo.bar ...中的=并将foo.bar设置为布尔值 true（就像配置文件中的[foo]bar一样）。包括等于但是空值（如git -c foo.bar= ...）将foo.bar设置为git config --type=bool将转换为false的空字符串。

 --exec-path[=<path>] 

安装核心 Git 程序的路径。这也可以通过设置 GIT_EXEC_PATH 环境变量来控制。如果没有给出路径， git 将打印当前设置然后退出。

 --html-path 

打印路径，不带斜杠，安装 Git 的 HTML 文档并退出。

 --man-path 

打印 manpath（参见man(1)）获取此版本 Git 的手册页并退出。

 --info-path 

打印安装记录此版本 Git 的 Info 文件的路径并退出。

 -p 

 --paginate 

如果标准输出是终端，则将所有输出管道输入 _ 减去 _（或如果设置为$ PAGER）。这将覆盖pager.<cmd>配置选项（请参阅下面的“配置机制”部分）。

 -P 

 --no-pager 

不要将 Git 输出传输到寻呼机。

 --git-dir=<path> 

设置存储库的路径。这也可以通过设置GIT_DIR环境变量来控制。它可以是当前工作目录的绝对路径或相对路径。

 --work-tree=<path> 

设置工作树的路径。它可以是绝对路径或相对于当前工作目录的路径。这也可以通过设置 GIT_WORK_TREE 环境变量和 core.worktree 配置变量来控制（有关更详细的讨论，请参阅 git-config [1] 中的 core.worktree）。

 --namespace=<path> 

设置 Git 名称空间。有关详细信息，请参阅 gitnamespaces [7] 。相当于设置GIT_NAMESPACE环境变量。

 --super-prefix=<path> 

目前仅供内部使用。设置一个前缀，该前缀提供从存储库上方到其根目录的路径。一个用途是给出调用它的超级项目的子模块上下文。

 --bare 

将存储库视为裸存储库。如果未设置 GIT_DIR 环境，则将其设置为当前工作目录。

 --no-replace-objects 

不要使用替换引用来替换 Git 对象。有关详细信息，请参阅 git-replace [1] 。

 --literal-pathspecs 

按字面意思处理 pathspecs（即没有 globbing，没有 pathspec magic）。这相当于将GIT_LITERAL_PATHSPECS环境变量设置为1。

 --glob-pathspecs 

为所有 pathspec 添加“glob”魔法。这相当于将GIT_GLOB_PATHSPECS环境变量设置为1。可以使用 pathspec magic“😦 literal）”在各个 pathspec 上禁用通配符

 --noglob-pathspecs 

为所有 pathspec 添加“literal”魔法。这相当于将GIT_NOGLOB_PATHSPECS环境变量设置为1。可以使用 pathspec magic“😦 glob）”在各个 pathspec 上启用 globbing

 --icase-pathspecs 

为所有 pathspec 添加“icase”魔法。这相当于将GIT_ICASE_PATHSPECS环境变量设置为1。

 --no-optional-locks 

不要执行需要锁定的可选操作。这相当于将GIT_OPTIONAL_LOCKS设置为0。

 --list-cmds=group[,group…​] 

按组列出命令。这是一个内部/实验选项，可能会在将来更改或删除。支持的组包括：builtins，parseopt（使用 parse-options 的内置命令），main（libexec 目录中的所有命令），其他（$PATH中具有 git-前缀的所有其他命令），list-< category> （请参阅 command-list.txt 中的类别），nohelpers（排除帮助程序命令），别名和配置（从配置变量 completion.commands 检索命令列表）

GIT 命令

我们将 Git 分为高级（“瓷器”）命令和低级（“管道”）命令。

高级命令（瓷器）

我们将瓷器命令分成主命令和一些辅助用户实用程序。

主要瓷器命令

 git-add[1] 

将文件内容添加到索引

 git-am[1] 

从邮箱中应用一系列修补程序

 git-archive[1] 

从命名树创建文件存档

 git-bisect[1] 

使用二进制搜索来查找引入错误的提交

 git-branch[1] 

列出，创建或删除分支

 git-bundle[1] 

通过存档移动对象和引用

 git-checkout[1] 

切换分支或恢复工作树文件

 git-cherry-pick[1] 

应用某些现有提交引入的更改

 git-citool[1] 

git-commit 的图形替代方案

 git-clean[1] 

从工作树中删除未跟踪的文件

 git-clone[1] 

将存储库克隆到新目录中

 git-commit[1] 

记录对存储库的更改

 git-describe[1] 

根据可用的 ref 给对象一个人类可读的名称

 git-diff[1] 

显示提交，提交和工作树等之间的更改

 git-fetch[1] 

从另一个存储库下载对象和引用

 git-format-patch[1] 

准备电子邮件提交补丁

 git-gc[1] 

清理不必要的文件并优化本地存储库

 git-grep[1] 

打印与图案匹配的线条

 git-gui[1] 

Git 的便携式图形界面

 git-init[1] 

创建一个空的 Git 存储库或重新初始化现有存储库

 gitk[1] 

Git 存储库浏览器

 git-log[1] 

显示提交日志

 git-merge[1] 

一起加入两个或多个开发历史

 git-mv[1] 

移动或重命名文件，目录或符号链接

 git-notes[1] 

添加或检查对象注释

 git-pull[1] 

从另一个存储库或本地分支获取并与其集成

 git-push[1] 

更新远程引用以及关联的对象

 git-range-diff[1] 

比较两个提交范围（例如，分支的两个版本）

 git-rebase[1] 

在另一个基本提示之上重新应用提交

 git-reset[1] 

将当前 HEAD 重置为指定状态

 git-revert[1] 

还原一些现有提交

 git-rm[1] 

从工作树和索引中删除文件

 git-shortlog[1] 

总结 git log 输出

 git-show[1] 

显示各种类型的对象

 git-stash[1] 

将更改存储在脏工作目录中

 git-status[1] 

显示工作树状态

 git-submodule[1] 

初始化，更新或检查子模块

 git-tag[1] 

创建，列出，删除或验证使用 GPG 签名的标记对象

 git-worktree[1] 

管理多个工作树

辅助命令

机器人：

 git-config[1] 

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

 git-fast-export[1] 

Git 数据导出器

 git-fast-import[1] 

快速 Git 数据导入器的后端

 git-filter-branch[1] 

重写分支

 git-mergetool[1] 

运行合并冲突解决工具以解决合并冲突

 git-pack-refs[1] 

打包头和标签以实现高效的存储库访问

 git-prune[1] 

从对象数据库中修剪所有无法访问的对象

 git-reflog[1] 

管理 reflog 信息

 git-remote[1] 

管理一组跟踪的存储库

 git-repack[1] 

在存储库中打包解压缩的对象

 git-replace[1] 

创建，列出，删除引用以替换对象

读写器：

 git-annotate[1] 

使用提交信息注释文件行

 git-blame[1] 

显示修订版和作者上次修改文件的每一行

 git-count-objects[1] 

计算解压缩的对象数量及其磁盘消耗量

 git-difftool[1] 

使用常见差异工具显示更改

 git-fsck[1] 

验证数据库中对象的连接性和有效性

 git-help[1] 

显示有关 Git 的帮助信息

 git-instaweb[1] 

立即在 gitweb 中浏览您的工作存储库

 git-merge-tree[1] 

显示三向合并而不触及索引

 git-rerere[1] 

重用已记录的冲突合并解决方案

 git-show-branch[1] 

显示分支及其提交

 git-verify-commit[1] 

检查提交的 GPG 签名

 git-verify-tag[1] 

检查标签的 GPG 签名

 gitweb[1] 

Git Web 界面（Web 前端到 Git 存储库）

 git-whatchanged[1] 

显示每个提交引入的差异日志

与他人互动

这些命令通过电子邮件补丁与外部 SCM 和其他人进行交互。

 git-archimport[1] 

将 GNU Arch 存储库导入 Git

 git-cvsexportcommit[1] 

将单个提交导出到 CVS 结帐

 git-cvsimport[1] 

从另一个喜欢讨厌的 SCM 中抢救你的数据

 git-cvsserver[1] 

Git 的 CVS 服务器模拟器

 git-imap-send[1] 

将 stdin 的补丁集合发送到 IMAP 文件夹

 git-p4[1] 

从 Perforce 存储库导入并提交到 Perforce 存储库

 git-quiltimport[1] 

将 quilt 补丁集应用于当前分支

 git-request-pull[1] 

生成待处理更改的摘要

 git-send-email[1] 

将一组补丁作为电子邮件发送

 git-svn[1] 

Subversion 存储库和 Git 之间的双向操作

低级命令（管道）

虽然 Git 包含自己的瓷层，但它的低级命令足以支持替代瓷器的开发。这些瓷器的开发者可能首先阅读 git-update-index [1] 和 git-read-tree [1] 。

这些低级命令的接口（输入，输出，选项集和语义）比 Porcelain 级别命令更稳定，因为这些命令主要用于脚本使用。另一方面，Porcelain 命令的界面可能会发生变化，以改善最终用户体验。

以下描述将低级命令划分为操作对象（在存储库，索引和工作树中）的命令，询问和比较对象的命令，以及在存储库之间移动对象和引用的命令。

操纵命令

 git-apply[1] 

将修补程序应用于文件和/或索引

 git-checkout-index[1] 

将文件从索引复制到工作树

 git-commit-graph[1] 

编写并验证 Git 提交图文件

 git-commit-tree[1] 

创建一个新的提交对象

 git-hash-object[1] 

计算对象 ID 并可选择从文件创建 blob

 git-index-pack[1] 

构建现有打包存档的包索引文件

 git-merge-file[1] 

运行三向文件合并

 git-merge-index[1] 

为需要合并的文件运行合并

 git-multi-pack-index[1] 

编写并验证多包索引

 git-mktag[1] 

创建标记对象

 git-mktree[1] 

从 ls-tree 格式的文本构建树对象

 git-pack-objects[1] 

创建对象的打包存档

 git-prune-packed[1] 

删除包文件中已有的额外对象

 git-read-tree[1] 

将树信息读入索引

 git-symbolic-ref[1] 

阅读，修改和删除符号引用

 git-unpack-objects[1] 

从打包存档中解压缩对象

 git-update-index[1] 

将工作树中的文件内容注册到索引

 git-update-ref[1] 

安全地更新存储在 ref 中的对象名称

 git-write-tree[1] 

从当前索引创建树对象

询问命令

 git-cat-file[1] 

提供存储库对象的内容或类型和大小信息

 git-cherry[1] 

查找尚未应用于上游的提交

 git-diff-files[1] 

比较工作树和索引中的文件

 git-diff-index[1] 

将树与工作树或索引进行比较

 git-diff-tree[1] 

比较通过两个树对象找到的 blob 的内容和模式

 git-for-each-ref[1] 

每个参考的输出信息

 git-get-tar-commit-id[1] 

从使用 git-archive 创建的存档中提取提交 ID

 git-ls-files[1] 

显示有关索引和工作树中文件的信息

 git-ls-remote[1] 

列出远程存储库中的引用

 git-ls-tree[1] 

列出树对象的内容

 git-merge-base[1] 

找到合并的尽可能好的共同祖先

 git-name-rev[1] 

查找给定转速的符号名称

 git-pack-redundant[1] 

查找冗余包文件

 git-rev-list[1] 

列出以反向时间顺序提交对象

 git-rev-parse[1] 

挑选和按摩参数

 git-show-index[1] 

显示打包归档索引

 git-show-ref[1] 

列出本地存储库中的引用

 git-unpack-file[1] 

创建一个包含 blob 内容的临时文件

 git-var[1] 

显示 Git 逻辑变量

 git-verify-pack[1] 

验证打包的 Git 存档文件

通常，询问命令不会触及工作树中的文件。

同步存储库

 git-daemon[1] 

Git 存储库的一个非常简单的服务器

 git-fetch-pack[1] 

从另一个存储库接收丢失的对象

 git-http-backend[1] 

服务器端实现 Git over HTTP

 git-send-pack[1] 

通过 Git 协议将对象推送到另一个存储库

 git-update-server-info[1] 

更新辅助信息文件以帮助虚拟服务器

以下是上面使用的帮助程序命令;最终用户通常不直接使用它们。

 git-http-fetch[1] 

通过 HTTP 从远程 Git 存储库下载

 git-http-push[1] 

通过 HTTP / DAV 将对象推送到另一个存储库

 git-parse-remote[1] 

有助于解析远程存储库访问参数的例程

 git-receive-pack[1] 

接收推入存储库的内容

 git-shell[1] 

受限制的登录 shell 仅用于 Git SSH 访问

 git-upload-archive[1] 

将存档发送回 git-archive

 git-upload-pack[1] 

将对象打包回 git-fetch-pack

内部帮助器命令

这些是其他命令使用的内部帮助程序命令;最终用户通常不直接使用它们。

 git-check-attr[1] 

显示 gitattributes 信息

 git-check-ignore[1] 

调试 gitignore / exclude 文件

 git-check-mailmap[1] 

显示联系人的规范名称和电子邮件地址

 git-check-ref-format[1] 

确保参考名称格式正确

 git-column[1] 

以列显示数据

 git-credential[1] 

检索并存储用户凭据

 git-credential-cache[1] 

帮助程序将密码临时存储在内存中

 git-credential-store[1] 

帮助程序将凭据存储在磁盘上

 git-fmt-merge-msg[1] 

生成合并提交消息

 git-interpret-trailers[1] 

在提交消息中添加或解析结构化信息

 git-mailinfo[1] 

从单个电子邮件中提取补丁和作者身份

 git-mailsplit[1] 

简单的 UNIX mbox 拆分程序

 git-merge-one-file[1] 

与 git-merge-index 一起使用的标准帮助程序

 git-patch-id[1] 

计算修补程序的唯一 ID

 git-sh-i18n[1] 

Git 的 shell 脚本的 i18n 设置代码

 git-sh-setup[1] 

常见的 Git shell 脚本设置代码

 git-stripspace[1] 

删除不必要的空格

配置机制

Git 使用简单的文本格式来存储每个存储库和每个用户的自定义项。这样的配置文件可能如下所示：

#
# A '#' or ';' character indicates a comment.
#

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

; user identity
[user]
	name = "Junio C Hamano"
	email = "gitster@pobox.com"

各种命令从配置文件中读取并相应地调整其操作。有关列表和有关配置机制的更多详细信息，请参见 git-config [1] 。

标识符术语

 <object> 

指示任何类型对象的对象名称。

 <blob> 

表示 blob 对象名称。

 <tree> 

表示树对象名称。

 <commit> 

表示提交对象名称。

 <tree-ish> 

表示树，提交或标记对象名称。采用< tree-ish>的命令参数最终想要在<树>上运行。对象但自动解除引用< commit>和< tag>指向< tree>的对象。

 <commit-ish> 

表示提交或标记对象名称。采用< commit-ish>的命令参数最终想要在< commit>上运行对象但自动解除引用< tag>指向< commit>的对象。

 <type> 

表示需要对象类型。目前之一：blob，tree，commit或tag。

 <file> 

表示文件名 - 几乎总是相对于树结构GIT_INDEX_FILE描述的根。

符号标识符

任何接受任何< object>的 Git 命令也可以使用以下符号表示法：

 HEAD 

表示当前分支的头部。

 <tag> 

有效标签 _ 名称 _（即refs/tags/<tag>参考）。

 <head> 

有效头 _ 名称 _（即refs/heads/<head>参考）。

有关拼写对象名称的更完整列表，请参阅 gitrevisions [7] 中的“指定修订”部分。

文件/目录结构

请参阅 gitrepository-layout [5] 文档。

有关每个钩子的更多详细信息，请阅读 githooks [5] 。

更高级别的 SCM 可以在$GIT_DIR中提供和管理附加信息。

术语

请参阅 gitglossary [7] 。

环境变量

各种 Git 命令使用以下环境变量：

Git 存储库

这些环境变量适用于 _ 所有 _ 核心 Git 命令。 Nb：值得注意的是，它们可能被 SCMS 上面的 GMS 使用/覆盖，所以如果使用外部前端则要小心。

 GIT_INDEX_FILE 

此环境允许指定备用索引文件。如果未指定，则使用$GIT_DIR/index的默认值。

 GIT_INDEX_VERSION 

此环境变量允许为新存储库指定索引版本。它不会影响现有的索引文件。默认情况下，使用索引文件版本 2 或 3。有关详细信息，请参阅 git-update-index [1] 。

 GIT_OBJECT_DIRECTORY 

如果通过此环境变量指定了对象存储目录，则在下面创建 sha1 目录 - 否则使用默认的$GIT_DIR/objects目录。

 GIT_ALTERNATE_OBJECT_DIRECTORIES 

由于 Git 对象的不可变特性，旧对象可以存档到共享的只读目录中。此变量指定一个“：”分隔（在 Windows 上;“分隔”）Git 对象目录列表，可用于搜索 Git 对象。新对象不会写入这些目录。

以"（双引号）开头的条目将被解释为 C 风格的引用路径，删除前导和尾随双引号并尊重反斜杠转义。例如，值"path-with-\"-and-:-in-it":vanilla-path有两条路径：path-with-"-and-:-in-it和vanilla-path。

 GIT_DIR 

如果设置了GIT_DIR环境变量，则它指定要使用的路径而不是存储库基础的默认.git。 --git-dir命令行选项也设置此值。

 GIT_WORK_TREE 

设置工作树根目录的路径。这也可以通过--work-tree命令行选项和 core.worktree 配置变量来控制。

 GIT_NAMESPACE 

设置 Git 名称空间;有关详细信息，请参阅 gitnamespaces [7] 。 --namespace命令行选项也设置此值。

 GIT_CEILING_DIRECTORIES 

这应该是以冒号分隔的绝对路径列表。如果设置，它是 Git 在查找存储库目录时不应该进入的目录列表（对于排除缓慢加载的网络目录很有用）。它不会排除当前工作目录或在命令行或环境中设置的 GIT_DIR。通常，Git 必须读取此列表中的条目并解析可能存在的任何符号链接，以便将它们与当前目录进行比较。但是，如果即使这种访问速度很慢，您也可以在列表中添加一个空条目，告诉 Git 后续条目不是符号链接，无需解析;例如，GIT_CEILING_DIRECTORIES=/maybe/symlink::/very/slow/non/symlink。

 GIT_DISCOVERY_ACROSS_FILESYSTEM 

当在没有“.git”存储库目录的目录中运行时，Git 会尝试在父目录中找到这样的目录以查找工作树的顶部，但默认情况下它不会跨越文件系统边界。可以将此环境变量设置为 true，以告知 Git 不要停在文件系统边界。与GIT_CEILING_DIRECTORIES类似，这不会影响通过GIT_DIR或命令行设置的显式存储库目录。

 GIT_COMMON_DIR 

如果将此变量设置为路径，则通常在 GIT_DIR 中的非工作树文件将从此路径中获取。特定于工作树的文件（如 HEAD 或索引）取自 GIT_DIR。有关详细信息，请参阅 gitrepository-layout [5] 和 git-worktree [1] 。此变量的优先级低于其他路径变量，例如 GIT_INDEX_FILE，GIT_OBJECT_DIRECTORY …

Git 承诺

 GIT_AUTHOR_NAME 

 GIT_AUTHOR_EMAIL 

 GIT_AUTHOR_DATE 

 GIT_COMMITTER_NAME 

 GIT_COMMITTER_EMAIL 

 GIT_COMMITTER_DATE 

 EMAIL 

见 git-commit-tree [1]

Git Diffs

 GIT_DIFF_OPTS 

只有有效设置为“–unified = ??”或者“-u ??”设置创建统一差异时显示的上下文行数。这优先于 Git diff 命令行上传递的任何“-U”或“–unified”选项值。

 GIT_EXTERNAL_DIFF 

设置环境变量GIT_EXTERNAL_DIFF时，将调用由其命名的程序，而不是上面描述的 diff 调用。对于添加，删除或修改的路径，使用 7 个参数调用GIT_EXTERNAL_DIFF：

path old-file old-hex old-mode new-file new-hex new-mode

哪里：

 <old|new>-file 

是文件 GIT_EXTERNAL_DIFF 可用于读取< old | new>的内容，

 <old|new>-hex 

是 40-hexdigit SHA-1 哈希，

 <old|new>-mode 

是文件模式的八进制表示。

文件参数可以指向用户的工作文件（例如“git-diff-files”中的new-file），/dev/null（例如添加新文件时的old-file）或临时文件（例如old-file）在索引中）。 GIT_EXTERNAL_DIFF不应该担心取消链接临时文件—当GIT_EXTERNAL_DIFF退出时它会被删除。

对于未合并的路径，使用 1 参数< path>调用GIT_EXTERNAL_DIFF。

对于每个路径GIT_EXTERNAL_DIFF被调用，设置了两个环境变量GIT_DIFF_PATH_COUNTER和GIT_DIFF_PATH_TOTAL。

 GIT_DIFF_PATH_COUNTER 

每个路径的基于 1 的计数器递增 1。

 GIT_DIFF_PATH_TOTAL 

路径总数。

其他

 GIT_MERGE_VERBOSITY 

控制递归合并策略显示的输出量的数字。覆盖 merge.verbosity。见 git-merge [1]

 GIT_PAGER 

此环境变量会覆盖$PAGER。如果将其设置为空字符串或值“cat”，则 Git 将不会启动寻呼机。另请参见 git-config [1] 中的core.pager选项。

 GIT_EDITOR 

此环境变量会覆盖EDITOR和VISUAL。当在交互模式下启动编辑器时，它由几个 Git 命令使用。另请参阅 git-var [1] 和 git-config [1] 中的core.editor选项。

 GIT_SSH 

 GIT_SSH_COMMAND 

如果设置了这些环境变量中的任何一个，则当需要连接到远程系统时， git fetch 和 git push 将使用指定的命令而不是 ssh 。传递给配置命令的命令行参数由 ssh 变量确定。有关详细信息，请参阅 git-config [1] 中的ssh.variant选项。

GIT_SSH_COMMAND优先于GIT_SSH，由 shell 解释，允许包含其他参数。另一方面，

通常，通过个人.ssh/config文件更容易配置任何所需的选项。有关详细信息，请参阅 ssh 文档。

 GIT_SSH_VARIANT 

如果设置了此环境变量，它将覆盖 Git 的自动检测，无论GIT_SSH / GIT_SSH_COMMAND / core.sshCommand是指 OpenSSH，plink 还是 tortoiseplink。此变量会覆盖用于相同目的的配置设置ssh.variant。

 GIT_ASKPASS 

如果设置了此环境变量，则需要获取密码或密码短语（例如，用于 HTTP 或 IMAP 身份验证）的 Git 命令将使用适当的提示作为命令行参数调用此程序，并从其 STDOUT 读取密码。另请参见 git-config [1] 中的core.askPass选项。

 GIT_TERMINAL_PROMPT 

如果此环境变量设置为0，则 git 将不会在终端上提示（例如，在请求 HTTP 身份验证时）。

 GIT_CONFIG_NOSYSTEM 

是否跳过从系统范围(prefix)/etc/gitconfig文件中读取设置。此环境变量可与HOME和

 GIT_FLUSH 

如果此环境变量设置为“1”，则命令如 git blame （在增量模式下）， git rev-list ， git log ， git check-attr 和 git check-ignore 将在刷新每条记录后强制刷新输出流。如果此变量设置为“0”，则将使用完全缓冲的 I / O 完成这些命令的输出。如果未设置此环境变量，Git 将根据 stdout 是否重定向到文件来选择缓冲或面向记录的刷新。

 GIT_TRACE 

启用常规跟踪消息，例如别名扩展，内置命令执行和外部命令执行。

如果此变量设置为“1”，“2”或“true”（比较不区分大小写），则跟踪消息将打印到 stderr。

如果变量设置为大于 2 且小于 10（严格）的整数值，则 Git 会将此值解释为打开文件描述符，并尝试将跟踪消息写入此文件描述符。

或者，如果变量设置为绝对路径（以 / 字符开头），Git 会将其解释为文件路径，并尝试将跟踪消息附加到其中。

取消设置变量或将其设置为空，“0”或“false”（不区分大小写）禁用跟踪消息。

 GIT_TRACE_FSMONITOR 

为文件系统监视器扩展启用跟踪消息。有关可用的跟踪输出选项，请参见GIT_TRACE。

 GIT_TRACE_PACK_ACCESS 

为所有对任何包的访问启用跟踪消息。对于每次访问，都会记录包文件名和包中的偏移量。这可能有助于解决一些与包相关的性能问题。有关可用的跟踪输出选项，请参见GIT_TRACE。

 GIT_TRACE_PACKET 

为进出特定程序的所有数据包启用跟踪消息。这有助于调试对象协商或其他协议问题。在以“PACK”开头的数据包中关闭跟踪（但请参见下面的GIT_TRACE_PACKFILE）。有关可用的跟踪输出选项，请参见GIT_TRACE。

 GIT_TRACE_PACKFILE 

允许跟踪给定程序发送或接收的包文件。与其他跟踪输出不同，此跟踪是逐字的：没有标头，也没有二进制数据的引用。您几乎肯定希望直接进入文件（例如，GIT_TRACE_PACKFILE=/tmp/my.pack），而不是将其显示在终端上或将其与其他跟踪输出混合。

请注意，这仅适用于克隆和提取的客户端。

 GIT_TRACE_PERFORMANCE 

启用与性能相关的跟踪消息，例如每个 Git 命令的总执行时间。有关可用的跟踪输出选项，请参见GIT_TRACE。

 GIT_TRACE_SETUP 

在 Git 完成其设置阶段后，启用跟踪消息打印.git，工作树和当前工作目录。有关可用的跟踪输出选项，请参见GIT_TRACE。

 GIT_TRACE_SHALLOW 

启用跟踪消息，以帮助调试获取/克隆浅存储库。有关可用的跟踪输出选项，请参见GIT_TRACE。

 GIT_TRACE_CURL 

启用 git 传输协议的所有传入和传出数据（包括描述性信息）的卷曲完整跟踪转储。这类似于在命令行上执行 curl --trace-ascii。此选项会覆盖设置GIT_CURL_VERBOSE环境变量。有关可用的跟踪输出选项，请参见GIT_TRACE。

 GIT_TRACE_CURL_NO_DATA 

启用卷曲跟踪时（参见上面的GIT_TRACE_CURL），不要转储数据（即只转储信息行和标题）。

 GIT_REDACT_COOKIES 

这可以设置为以逗号分隔的字符串列表。当启用卷曲跟踪时（参见上面的GIT_TRACE_CURL），每当转储客户端发送的“Cookies：”头时，其密钥在该列表中的 cookie（区分大小写）的值将被编辑。

 GIT_LITERAL_PATHSPECS 

将此变量设置为1将导致 Git 按字面处理所有 pathspec，而不是作为 glob 模式。例如，运行GIT_LITERAL_PATHSPECS=1 git log -- '*.c'将搜索触及路径*.c的提交，而不是 glob *.c匹配的任何路径。如果要向 Git 提供文字路径（例如，之前通过git ls-tree，--raw diff 输出等给你的路径），你可能会想要这个。

 GIT_GLOB_PATHSPECS 

将此变量设置为1将导致 Git 将所有 pathspecs 视为 glob 模式（也称为“glob”魔术）。

 GIT_NOGLOB_PATHSPECS 

将此变量设置为1将导致 Git 将所有 pathspecs 视为文字（也称为“文字”魔法）。

 GIT_ICASE_PATHSPECS 

将此变量设置为1将导致 Git 将所有 pathspec 视为不区分大小写。

 GIT_REFLOG_ACTION 

更新 ref 时，除了 ref 的旧值和新值之外，还会创建 reflog 条目以跟踪 ref 更新的原因（通常是更新 ref 的高级命令的名称） 。脚本化的 Porcelain 命令可以使用git-sh-setup中的 set_reflog_action 辅助函数将其名称设置为此变量，当它被最终用户作为顶级命令调用时，将记录在 reflog 的主体中。

 GIT_REF_PARANOIA 

如果设置为1，则在迭代 refs 列表时包含损坏或命名错误的引用。在正常的，未损坏的存储库中，这没有任何作用。但是，启用它可能有助于 git 在存在损坏的 refs 的情况下检测并中止某些操作。当执行像 git-prune [1] 这样的破坏性操作时，Git 会自动设置此变量。您不应该自己设置它，除非您想要确保操作已触及每个参考（例如，因为您正在克隆存储库以进行备份）。

 GIT_ALLOW_PROTOCOL 

如果设置为以冒号分隔的协议列表，则表现为protocol.allow设置为never，并且每个列出的协议都将protocol.<name>.allow设置为always（覆盖任何现有配置）。换句话说，将不允许任何未提及的协议（即，这是白名单，而不是黑名单）。有关详细信息，请参阅 git-config [1] 中protocol.allow的说明。

 GIT_PROTOCOL_FROM_USER 

设置为 0 以防止 fetch / push / clone 使用的协议配置为user状态。这对于限制来自不受信任的存储库的递归子模块初始化或对于将可能不受信任的 URL 提供给 git 命令的程序非常有用。有关详细信息，请参阅 git-config [1] 。

 GIT_PROTOCOL 

仅限内部使用。用于握线协议。包含一个冒号 ： 分隔的键列表，其中包含可选值 _ 键[= value]_ 。必须忽略未知键和值的存在。

 GIT_OPTIONAL_LOCKS 

如果设置为0，Git 将完成任何请求的操作，而不执行任何需要锁定的可选子操作。例如，这将阻止git status刷新索引作为副作用。这对于在后台运行的进程非常有用，这些进程不希望与存储库上的其他操作引起锁争用。默认为1。

 GIT_REDIRECT_STDIN 

 GIT_REDIRECT_STDOUT 

 GIT_REDIRECT_STDERR 

仅限 Windows：允许将标准输入/输出/错误句柄重定向到环境变量指定的路径。这在多线程应用程序中特别有用，其中通过CreateProcess()传递标准句柄的规范方法不是一个选项，因为它需要将句柄标记为可继承（因此每个生成的进程都将继承它们） ，可能阻止常规的 Git 操作）。主要用途是使用命名管道进行通信（例如\\.\pipe\my-git-stdin-123）。

支持两个特殊值：off将关闭相应的标准句柄，如果GIT_REDIRECT_STDERR为2>&1，标准错误将重定向到与标准输出相同的句柄。

 GIT_PRINT_SHA1_ELLIPSIS (deprecated) 

如果设置为yes，则在（缩写）SHA-1 值后面打印省略号。这会影响分离的 HEAD（ git-checkout [1] ）和原始 diff 输出（ git-diff [1] ）的指示。在所提到的情况下打印省略号不再被认为是足够的，并且在可预见的将来可能会删除对它的支持（以及变量）。

讨论

有关以下内容的更多详细信息，请参见用户手册和 gitcore-tutorial [7] 的 Git 概念章节。

Git 项目通常包含一个工作目录，顶层有一个“.git”子目录。 .git 目录包含一个表示项目完整历史记录的压缩对象数据库，一个将该历史记录链接到工作树的当前内容的“索引”文件，以及指向该历史记录的指针，如标记和分公司负责人

对象数据库包含三种主要类型的对象：blob，用于保存文件数据;树，指向 blob 和其他树来构建目录层次结构;和提交，每个引用一个树和一些父提交。

相当于其他系统称为“变更集”或“版本”的提交代表项目历史中的一个步骤，每个父项代表紧接在前的步骤。具有多个父项的提交代表独立开发线的合并。

所有对象都由其内容的 SHA-1 哈希命名，通常写为 40 个十六进制数字的字符串。这些名称是全球唯一的。通过签署该提交，可以保证导致提交的整个历史记录。为此目的提供第四对象类型，标签。

首次创建时，对象存储在单个文件中，但为了提高效率，以后可以将它们一起压缩为“包文件”。

名为 refs 的命名指针标记历史中的有趣点。 ref 可以包含对象的 SHA-1 名称或另一个 ref 的名称。名称以ref/head/开头的引用包含正在开发的分支的最新提交（或“头部”）的 SHA-1 名称。感兴趣的标签的 SHA-1 名称存储在ref/tags/下。名为HEAD的特殊引用包含当前签出分支的名称。

索引文件使用所有路径的列表进行初始化，并为每个路径初始化 blob 对象和一组属性。 blob 对象表示当前分支头部的文件内容。属性（上次修改时间，大小等）取自工作树中的相应文件。通过比较这些属性可以找到对工作树的后续更改。可以用新内容更新索引，并且可以从存储在索引中的内容创建新提交。

索引还能够存储给定路径名的多个条目（称为“阶段”）。这些阶段用于在合并进行时保存文件的各种未合并版本。

进一步的文件

请参阅“说明”部分中的参考资料以开始使用 Git。以下可能是首次使用者所需的详细信息。

用户手册和 gitcore-tutorial [7] 的 Git 概念章节都提供了对底层 Git 架构的介绍。

有关推荐工作流程的概述，请参见 gitworkflows [7] 。

有关一些有用的示例，另请参见 howto 文档。

内部结构记录在 Git API 文档中。

从 CVS 迁移的用户可能还想阅读 gitcvs-migration [7] 。

作者

Git 由 Linus Torvalds 创办，目前由 Junio C Hamano 维护。许多贡献来自 Git 邮件列表< git@vger.kernel.org >。 www.openhub.net/p/git/contributors/summary 为您提供了更完整的贡献者列表。

如果你自己克隆了 git.git，那么 git-shortlog [1] 和 git-blame [1] 的输出可以向你展示项目特定部分的作者。

报告错误

将错误报告给 Git 邮件列表< git@vger.kernel.org >主要完成开发和维护的地方。您无需订阅列表即可在其中发送消息。有关以前的错误报告和其他讨论，请参阅 public-inbox.org/git 的列表存档。

与安全相关的问题应私下披露给 Git Security 邮件列表< git-security@googlegroups.com >。

也可以看看

gittutorial [7] ， gittutorial-2 [7] ， giteveryday [7] ， gitcvs-migration [7] ， gitglossary [7] ， gitcore-tutorial [7] ， gitcli [7] ， Git 用户手册， gitworkflows [7 ]

GIT

部分 git [1] 套件

git-config

原文： git-scm.com/docs/git-config 贡献者：honglyua

名称

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

概要

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

描述

您可以使用此命令查询/设置/替换/取消设置选项。该名称实际上是由一个点分隔的配置项名和键名组成，即name 相当于<section>.<key>，执行git config <section>.<key>后，该配置项设置的值将被输出。

可以使用--add为某个配置项添加多个值。如果要更新或取消某个配置项，而这个配置项存在多个值时，你需要给出值后缀的正则表达式value_regex。它只更新或取消与正则表达式匹配的设置值。如果你想处理那些与正则表达式不匹配的设置行，只需在前面添加一个感叹号（另见示例）。

--type=<type>选项是为了保证以给定的 type 去规范化输入和输出 git config 中配置项的值。如果没有给出--type=<type>，则不执行规范化。调用者可以使用--no-type取消设置里已有的--type说明符。

读取时，默认情况下会从系统，全局和存储库本地配置文件中读取值，并且可以使用选项--system，--global，--local，--worktree和--file <filename>来告诉命令读取哪里的配置文件（参见 FILES ）。

写入时，默认情况下会将新值写入存储库本地配置文件，并且可以使用选项--system，--global，--worktree，--file <filename>来告诉命令写入该位置（可以使用--local但这是默认选项）。

出错时，此命令将失败，并以非零状态码退出。一些退出状态码有：

• 部分或键无效（ret = 1），
• 没有提供配置选项或名称（ret = 2），
• 配置文件无效（ret = 3），
• 配置文件无法写入（ret = 4），
• 你试图取消一个不存在的选项（ret = 5），
• 您在尝试取消设置/设置配置选项时，该配置项拥有多行配置（ret = 5），或
• 您在尝试使用无效的正则表达式（ret = 6）。

成功时，该命令返回退出状态码 0。

选项

 --replace-all 

默认行为是最多替换一行。它将会替换与键匹配的所有行（以及有可选的 value_regex）。

 --add 

在不更改任何现有值的情况下向选项添加新行。这与在--replace-all中以 ^ $ 作为 value_regex 的值相同。

 --get 

获取给定键的值（可选择通过与值匹配的正则表达式进行过滤）。如果未找到对应键值，则返回错误状态码 1；如果找到多个键值对，则返回最后一个值。

 --get-all 

与 get 类似，但返回所有键值对的值。

 --get-regexp 

与–get-all 类似，输出所有与正则表达式匹配的键值对，并输出键名和对应值。正则表达式匹配目前区分大小写，并且针对键的规范化版本完成，其中段和变量名称是小写的，但子段名称不是。

 --get-urlmatch name URL 

如果给出了一个由两部分组成的配置项名称 section.key，则返回与最匹配的值（如果不存在此配置名，则 section.key 的值用作回退）。如果仅将输入 section，则返回所有与 section 匹配的键值对。如果未找到值，则返回错误代码 1。

 --global 

对于写入选项：写入全局配置文件~/.gitconfig，而不是存储库配置文件.git/config。如果全局配置文件不存在而XDG_CONFIG_HOME/git/config文件存在，则写入XDG_CONFIG_HOME/git/config文件。

对于读取选项：只读取~/.gitconfig和$XDG_CONFIG_HOME/git/config文件中的配置，而不是所有可用文件中的。

另见 FILES 。

 --system 

对于写入选项：写入系统路径下的配置文件$(prefix)/etc/gitconfig，而不是存储库配置文件.git/config。

对于读取选项：只读取系统路径下的配置文件$(prefix)/etc/gitconfig中的配置，而不是所有可用文件中的。

另见 FILES 。

 --local 

对于写入选项：写入存储库配置文件.git/config中。这是默认行为。

对于读取选项：只读取存储库配置文件.git/config中的配置，而不是所有可用文件中的。

另见 FILES 。

 --worktree 

与--local类似，但如果extensions.worktreeConfig存在，则读取或写入.git/config.worktree中。如果不存在，它与--local效果相同。

 -f config-file 

 --file config-file 

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

 --blob blob 

与--file类似，但给定是 blob 路径而不是文件路径。例如。您可以使用 master:.gitmodules，从 master 分支中的文件.gitmodules中读取配置值。有关拼写 blob 名称的更完整列表，请参阅 gitrevisions [7] 中的“指定修订”部分。

 --remove-section 

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

 --rename-section 

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

 --unset 

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

 --unset-all 

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

 -l

--list 

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

 --type <type> 

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

有效<type>包括：

• bool ：将值规范化为“true”或“false”。
• int ：将值规范化为简单的十进制数。 k，m 或 g 的可选后缀将使该值在输入时乘以 1024，1048576 或 1073741824。
• bool-or-int ：根据 bool 或 int 进行标准化，如上所述。
• 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 不规范化检索到的变量。没有--type=<type>或--<type>，--no-type也不会受影响。

 -z 

 --null 

对于输出值或键名时，始终使用空字符（而不是换行符）作为结束字符串。使用换行符作为键和值之间的分隔符。这允许准确地解析输出而不会混淆，例如包含换行符的值。

 --name-only 

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

 --show-origin 

增加输出内容：origin 的类型（文件，标准输入，blob，命令行）和 origin 的指向（配置文件路径，ref 或 blob id，如果适用）

 --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作为后备。

 --get-color name [default] 

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

--type=color [--default=<default>]优于--get-color。

 -e 

 --edit 

打开编辑器，修改指定的配置文件; --system，--global或存储库（默认）。

 --[no-]includes 

在配置文件中查找值时，会考虑使用include.*指令。如果给出特定文件（例如，使用--file，--global等），则功能默认是off。如果在搜索所有配置文件时，功能是on

 --default <value> 

使用--get时，找不到请求的变量时，其行为就像是赋给该变量的值。

配置

当使用--list或可能有多个返回结果的--get-*时，会遵守pager.config列出配置。默认是使用分页的。

文件

如果未使用--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_DIR/config.worktree 

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

如果没有给出进一步的选项，在读取所有配置选项时，将从以上所有可用的文件中读取。如果全局或系统范围的配置文件不可用，则它们将会被忽略。如果存储库配置文件不可用或不可读，git config将以非零错误状态退出。但是，在任何情况下都不会发出错误消息。

按上面给出的顺序读取配置文件中的配置，新读到的配置值将会覆盖之前读到的。当获取多个值时，将使用来自所有文件的键的所有值。

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

所有配置选项写入时，都将默认写入到当前存储库的配置文件中。请注意，这也会影响--replace-all和--unset等选项。 git config 一次只能更改一个配置文件中配置。

您可以通过命令行选项或环境变量覆盖这些规则。 --global，--system和--worktree选项将分别限制用于全局，系统范围和每个工作树的配置文件。 GIT_CONFIG环境变量具有类似的效果，但您可以指定所需的任何文件名。

环境变量

 GIT_CONFIG 

从给定文件而不是.git/config 中获取配置。使用“–global”选项将强制使用~/.gitconfig。使用“–system”选项强制使用$(前缀)/etc/gitconfig。

 GIT_CONFIG_NOSYSTEM 

是否跳过从系统配置文件$(前缀)/etc/gitconfig 中读取设置。有关详细信息，请参阅git[1]。

另见 FILES。

例子

给出像这样的.git / config：

#
# 给出像这样的, 
# '#' 或者 ';' 是表示注释
#

; 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 的键/值对。

要删除 diff 的重命名配置，请执行

% 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

% 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的 URL，http.sslVerify设置为 false，而其他所有 URL 设置为true：

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

配置文件

Git 配置文件包含许多影响 Git 命令行为的变量。每个存储库中的文件.git/config和可选config.worktree（参见下面的extensions.worktreeConfig）用于存储该存储库的配置，$HOME/.gitconfig用于存储每用户配置，会回退.git/config文件中的配置。文件/etc/gitconfig可用于存储系统范围的默认配置。

配置变量由 Git 管道和瓷器使用。变量拆分为 sections，其中变量名称是最后一个点分隔的后面段，而 section 名称是最后一个点之前的所有内容。变量名称不区分大小写，仅允许使用字母数字字符和-，并且必须以字母字符开头。一些变量可能会出现多次；我们说那个变量是多值的。

句法

语法相当灵活和宽容；空白大多被忽略了。＃ 号和 ; 分号表示该字符开始到行尾都是注释，空行被忽略。

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

section 可以进一步划分为小的 section。要开始小的 section，请将其名称放在双引号中，并用空格与 section 隔开，如下例所示：

	[section "subsection"]

子节名称区分大小写，可以包含除换行符和空字节之外的任何字符。可以通过\"和\\转义，包含双引号和反斜杠。读取时会删除其他字符前面的反斜杠；例如，\t读取为t，\0读取为0，section 不能跨越多行。变量可以直接属于某个 section 或给定的子 section。你可以有[section]，但是可以不必有[section "subsection"]。

还有一个不推荐使用的[section.subsection]语法。使用此语法，子 section 名称将转换为小写，并且还区分大小写。这些子 section 名称遵循与 section 名称相同的限制。

所有其他行（以及节标题后面的行的其余部分）被识别为设置变量，形式为 name = value（或者只是name，通过一个短划线用来说明变量是布尔值“true”）。变量名称不区分大小写，仅允许使用字母、数字字符和-，并且必须以字母开头。

定义值的行可以通过以\结束来继续到下一行；反引号和行尾被剥离。name = 之后的空格，第一个注释字符＃或;之后的行的剩余部分，和该行尾部的空格都会被被丢弃，除非它们用双引号括起来。值中的内部空格逐字保留。

在双引号内，使用双引号"和反斜杠\字符必须转义：对"使用\"，而对\使用\\。

识别以下转义序列（在\"和\\旁边）：换行符（NL）的\n，水平制表的\t（HT，TAB）和退格（BS）的\b。其他 char 转义序列（包括八进制转义序列）无效。

包括

include和includeIf部分允许您包含来自其他来源的配置指令。这些 section 的行为相同，但includeIf的 section 如果其条件未评估为真则可以忽略；请参阅下面的“条件包含”。

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

文件的内容会被立刻载入配，就好像它们已在 include 伪指令的位置找到一样。如果变量的值是相对路径，则该路径被认为是相对于包含 include 伪指令的配置文件路径。请参阅下面的示例。

有条件的包括

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

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

 gitdir 

关键字gitdir:后面的数据用作 glob 模式。如果.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相同，只是匹配是不区分大小写的（例如，在不区分大小写的文件系统上）

关于通过gitdir和gitdir/i进行匹配的更多注意事项：

• $GIT_DIR中的符号链接在匹配之前未解析。
• 符号链接和路径的 realpath 版本将在$GIT_DIR之外匹配。例如，如果~/git是/mnt/storage/git的符号链接，那么gitdir:~/git和gitdir:/mnt/storage/git都会匹配。 在 v2.13.0 中此功能的初始版本中并非如此，该版本仅匹配 realpath 版本。想要与此功能的初始版本兼容的配置需要仅指定 realpath 版本或两个版本。
• 请注意，“…/”并不特殊，并且会按字面意思匹配，这不太可能是您想要的。

示例

# 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 

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

 true 

字面意思是yes，on，true和1。此外，变量没有定义= <value>的话，默认值是 true。

 false 

字面意思是no，off，false，0和空字符串。

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

 integer 

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

 color 

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

接受的基本颜色是normal，black，red，green，yellow，blue，magenta，cyan和white。给出的第一种颜色是前景，第二是背景。

颜色也可以作为 0 到 255 之间的数字给出，这些使用 ANSI 256 色模式（但请注意，并非所有终端都支持此功能）。如果您的终端支持它，您也可以将 24 位 RGB 值指定为十六进制，如#ff0ab3。

接受的属性有bold，dim，ul，blink，reverse，italic和strike（用于划掉或“删除”字母）。任何属性相对于颜色（之前，之后或之间）的位置都无关紧要。可以通过在前缀no或no-（例如，noreverse，no-ul等）来关闭特定属性。

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

对于 git 的预定义颜色槽，属性应在彩色输出中每个项目的开头重置。因此，将color.decorate.branch设置为black将在普通black中绘制该分支名称，即使同一输出行上的前一项（例如log --decorate输出中的分支名称列表前的左括号）设置为被涂上bold或其他一些属性。但是，自定义日志格式可能会执行更复杂和分层的着色，而否定的格式在那里可能会有用。

 pathname 

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

变量

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

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

 advice.* 

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

 pushUpdateRejected 

如果要同时禁用 pushNonFFCurrent，pushNonFFMatching ， pushAlreadyExists ，和 pushFetchFirst，和 pushNeedsForce 变量，请将此变量设置为 false。

 pushNonFFCurrent 

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

 pushNonFFMatching 

当您运行 git-push [1] 并显式推送 _ 匹配 refs_ 时显示的建议（即您使用 ：，或指定了不是您当前的 refspe 分支）并导致非快进错误。

 pushAlreadyExists 

当 git-push [1] 拒绝不符合快进条件的更新（例如，标签）时显示。

 pushFetchFirst 

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

 pushNeedsForce 

当 git-push [1] 拒绝尝试覆盖指向不是 commit-ish 的对象的远程 ref 的更新时，或者在不是 commit-ish 的对象上进行远程 ref 操作。

 pushUnqualifiedRefname 

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

 statusHints 

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

 statusUoption 

建议考虑在 git-status [1] 中使用-u选项，当命令需要超过 2 秒来枚举未跟踪文件时。

 commitBeforeMerge 

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

 resetQuiet 

建议考虑在 git-reset [1] 中使用--quiet选项，当命令需要 2 秒以上的时间来枚举复位后的非分段更改时。

 resolveConflict 

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

 implicitIdentity 

在从系统用户名和域名中猜出您的信息时，如何设置身份配置的建议。

 detachedHead 

使用 git-checkout [1] 移动到分离 HEAD 状态时显示的建议，以指示如何在事后创建本地分支。

 checkoutAmbiguousRemoteBranchName 

当 git-checkout [1] 的参数，在有多个远端的场景下，模糊地解析为远程跟踪分支时，如果明确的参数会导致远程跟踪分支被检出，则显示建议。请参阅checkout.defaultRemote配置变量，如何在给定远端的某些场景下使用。

 amWorkDir 

当 git-am [1] 无法应用时，显示补丁文件位置的建议。

 rmHints 

如果 git-rm [1] 的输出失败，请显示如何从当前状态开始的指示。

 addEmbeddedRepo 

当你意外地在另一个内部添加一个 git repo 时该怎么做的建议。

 ignoredHook 

如果钩子被忽略，则显示建议，因为钩子未设置为可执行文件。

 waitingForEditor 

只要 Git 正在等待用户的编辑输入，就将消息打印到终端。

 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 之间共享存储库时，这非常有用。（需要适用于 Windows 1.7.10 或更高版本的 Git，或者在 cygwin 1.7 下使用 Git）。如果为 false，则 Git 会完全透明文件名，后者与旧版本的 Git 向后兼容。

 core.protectHFS 

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

 core.protectNTFS 

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

 core.fsmonitor

如果设置，则此变量的值将用作命令，该命令将标识自请求的日期/时间以来可能已更改的所有文件。此信息用于通过避免对未更改的文件进行不必要的处理来加速 git 操作。请参阅 githooks [5] 的“fsmonitor-watchman”部分。

 core.trustctime 

如果为 false，则忽略索引与工作树之间的 ctime 差异；当 inode 更改时间被 Git 之外的某些东西（文件系统爬虫和一些备份系统）定期修改时，将非常有用。参见 git-update-index [1] 。默认为 True。

 core.splitIndex 

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

 core.untrackedCache 

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

 core.checkStat 

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

Git 的实现不会在某些字段中留下可用的值（例如 JGit）;通过从比较中排除这些字段，当同个仓库在被其他系统使用时，minimal模式可以帮助实现互操作性。

 core.quotePath 

输出路径的命令（例如 ls-files ， diff ）将在路径名中引用“异常”字符，方法是将路径名括在双引号中并使用反斜杠转义那些字符。和在 C 语言中转义控制字符（例如 TAB 为\t，LF 为\n，反斜杠为\\）或值大于 0x80 的字节（例如，UTF-8 中为“micro”的八进制\302\265）使用的同样的方法。如果此变量设置为 false，则高于 0x80 的字节不再被视为“异常”。无论此变量的设置如何，双引号，反斜杠和控制字符始终都会被转义。简单的空格字符不被视为“不寻常”。许多命令可以使用-z选项完全逐字输出路径名。默认值是 true。

 core.eol 

设置要在工作目录中用于标记为文本的文件的行结束类型（通过设置text属性，或者使text=auto和 Git 自动检测内容为文本）。替代品是 lf ， crlf 和 native，它使用平台的原生的行结束符。默认值为native。有关行尾转换的更多信息，请参见 gitattributes [5] 。请注意，如果core.autocrlf设置为true或input，则忽略该值。

 core.safecrlf 

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

CRLF 转换有可能破坏数据。启用时，Git 会在提交期间将 CRLF 转换为 LF，在检出时将 LF 转换为 CRLF。 Git 无法重新创建提交之前包含 LF 和 CRLF 混合的文件。对于文本文件，正确的做法是：它校正行结尾符，这样我们在存储库中只有 LF 行结尾。但对于意外归类为文本的二进制文件，转换可能会破坏数据。

如果您提前识别出此类损坏，则可以通过在.gitattributes 中明确设置转换类型来轻松解决此问题。提交后，您仍然在工作树中保留原始文件，此文件尚未损坏。你可以明确告诉 Git 这个文件是二进制文件，Git 会适当地处理文件。

不幸的是，无法区分清除具有混合行结尾的文本文件和破坏二进制文件的不良影响的期望效果。在这两种情况下，CRLF 都以不可逆转的方式被移除。对于文本文件，这是正确的做法，因为 CRLF 是行结尾，而对于二进制文件，转换 CRLF 会破坏数据。

请注意，此安全检查并不意味着在坚持文件时，将为core.eol和core.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 

逗号和/或空格分隔的编码列表，Git 执行 UTF-8 往返检查它们是否在working-tree-encoding属性中使用（参见 gitattributes [5] ）。默认值为SHIFT-JIS。

 core.symlinks 

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

默认值为 true，除了 git-clone [1] 或 git-init [1] 将在创建存储库时预测并设置 core.symlinks 为 false。

 core.gitProxy 

执行（作为 _ 命令主机端口 _）的“代理命令”，在使用 Git 协议进行更新时，将建立替代与远程服务器的直接连接方式。如果变量值在“COMMAND for DOMAIN”格式中，则该命令仅应用于以指定域字符串结尾的主机名。该变量可以多次设置并按给定顺序匹配；第一次匹配上就不继续往下匹配了。

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

特殊字符串none可用作代理命令，以指定不为给定的域模式使用代理。这对于从代理使用中排除防火墙内的服务器非常有用，同时默认为外部域的公共代理。

 core.sshCommand 

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

 core.ignoreStat 

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

当在 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，则假定此存储库为 bare 并且没有与之关联的工作目录。如果是这种情况，将禁用许多与工作目录相关的命令，例如 git-add [1] 或 git-merge [1] 。

创建存储库时， git-clone [1] 或 git-init [1] 会自动预测此设置。默认情况下，假定以“/.git”结尾的存储库不是 bare（bare=false），而假定所有其他存储库都是 bare（bare=ture）。

 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，则会自动为分支头创建缺省的“

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

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

 core.repositoryFormatVersion 

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

 core.sharedRepository 

当 _ 组 _（或 true ）时，存储库可在组中的多个用户之间共享（确保所有文件和对象都是组内可写的）。当 _ 所有 _（或 _ 世界 _ 或 _ 所有人 _）时，除了可分组之外，所有用户都可以读取存储库。当 umask （或 false ）时，Git 将使用 umask（2）报告的权限。当 0xxx ，其中 0xxx 是八进制数时，存储库中的文件将具有此模式值。 0xxx 将覆盖用户的 umask 值（而其他选项只会覆盖用户的 umask 值的请求部分）。示例： 0660 将对所有者和组进行可读/可写，但其他人无法访问（相当于 _ 组 _，除非 umask 是例如 0022 ） 。 0640 是一个可读取组但不可写入组的存储库。参见 git-init [1] 。默认为 False。

 core.warnAmbiguousRefs 

如果为 true，Git 会警告您，如果您传递的引用名称不明确并且可能与存储库中的多个引用相匹配。默认为 True。

 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 

在单个映射操作中映射到内存的 pack 文件的字节数。设置大的值时，可以允许您的系统更快地处理较少数量的大包文件。设置较小值时，会因调用操作系统内存管理器频繁，而导致对性能产生负面影响，但在访问大量大型文件包时可能会提高性能。

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

支持 k ， m 或 g 的通用单位后缀。

 core.packedGitLimit 

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

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

支持 k ， m 或 g 的通用单位后缀。

 core.deltaBaseCacheLimit 

保留用于缓存可能由多个已分层对象引用的基础对象的最大字节数。通过将整个解压缩的基础对象存储在高速缓存中，Git 能够避免多次解包和解压缩经常使用的基础对象。

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

支持 k ， m 或 g 的通用单位后缀。

 core.bigFileThreshold 

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

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

支持 k ， m 或 g 的通用单位后缀。

 core.excludesFile 

除了 .gitignore （每个目录）和 .git/info/exclude 之外，还可指定包含不打算跟踪的文件路径名。默认为XDG_CONFIG_HOME/git/ignore。如果XDG_CONFIG_HOME未设置或为空，则使用

 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未设置或为空，则使用

 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.editor 

当此值被设置时，并且未设置环境变量GIT_EDITOR，在执行类似commit和tag等命令时，允许您通过启动编辑器编辑消息。见 git-var [1] 。

 core.commentChar 

在执行类似commit和tag等命令时，会在编辑消息的开头的添加设置的字符，并在编辑器退出后删除它们（默认 ＃）。

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

 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 根本不会更改它）。如果您想有选择地覆盖LESS的 Git 默认设置，您可以将core.pager设置为例如less -S。这将由 Git 传递给 shell，它将最终命令转换为LESS=FRX less -S。环境不设置S选项，但命令行会设置，指示较少截断长行。同样，将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-space是涵盖blank-at-eol和blank-at-eof的简写。
• cr-at-eol将行尾处的回车处理作为行终止符的一部分，即使用它，如果此回车符之前的字符不是空格（默认情况下未启用），则trailing-space不会触发。
• tabwidth=<n>告诉标签占用多少个字符位置;这与indent-with-non-tab和 Git 修复tab-in-indent错误有关。默认选项卡宽度为 8.允许的值为 1 到 63。

 core.fsyncObjectFiles 

在编写目标文件时，此布尔值将启用 fsync（）。

这对于正确排序数据的文件系统来说是浪费时间和精力的，但对于不使用日志（传统 UNIX 文件系统）或仅使用日志元数据而不是文件内容（OS X 的 HFS+或 Linux）的文件系统非常有用。 ext3 带有“data = writeback”）。

 core.preloadIndex 

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

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

 core.unsetenvvars 

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

 core.createObject 

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

在某些文件系统/操作系统组合上，这是不可靠的。将此配置设置为 rename；但是，这将删除检查，以确保不会覆盖现有的目标文件。

 core.notesRef 

显示提交消息时，还会显示存储在给定引用中的注释。ref 必须完全合格。如果给定的 ref 不存在，则不是错误，而是表示不应打印​​任何注释。

此设置默认为“refs/notes/commits”，它可以被GIT_NOTES_REF环境变量覆盖。见 git-notes [1] 。

 core.commitGraph 

如果为 true，则 git 将读取 commit-graph 文件（如果存在）以解析提交的图形结构。默认为 false。有关详细信息，请参阅 git-commit-graph [1] 。

 core.useReplaceRefs 

如果设置为false，则表现为在命令行上给出了--no-replace-objects选项。有关详细信息，请参阅 git [1] 和 git-replace [1] 。

 core.multiPackIndex 

使用 multi-pack-index 文件使用单个索引跟踪多个 packfiles。请参见多包装索引设计文档。

 core.sparseCheckout 

启用“稀疏检出”功能。有关详细信息，请参阅 git-read-tree [1] 中的“稀疏检出”部分。

 core.abbrev 

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

 add.ignoreErrors 
 add.ignore-errors (deprecated) 

告诉 git add 在继续添加文件时，由于索引错误而无法添加某些文件。相当于 git-add [1] 的--ignore-errors选项。不推荐使用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 rev-parse --show-prefix 来设置GIT_PREFIX。参见 git-rev-parse [1] 。

 am.keepcr 

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

 am.threeWay 

默认情况下，如果补丁不能完全应用，git am将失败。当设置为 true 时，如果补丁记录了应该应用的 blob 的身份，则此设置告诉git am回退到三向合并，并且我们在本地可以获得这些 blob（相当于提供--3way选项命令行）。默认为false。见 git-am [1] 。

 apply.ignoreWhitespace 

当设置为 chang 时，告诉 git apply 忽略空白的变化，与--ignore-space-change选项相同。设置为以下之一：no，none，never，false 告诉 git apply 尊重所有空格差异。参见 git-apply [1] 。

 apply.whitespace 

告诉 git apply 如何处理空格，方法与--whitespace选项相同。参见 git-apply [1] 。

 blame.blankBoundary 

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

 blame.coloring 

这确定了应用于非 blame 输出的着色方案。它可以是 repeatedLines ， highlightRecent 或 none 这是默认值。

 blame.date 

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

 blame.showEmail 

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

 blame.showRoot 

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

 branch.autoSetupMerge 

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

 branch.autoSetupRebase 

当使用跟踪另一个分支的 git branch 或 git checkout 创建一个新分支时，此变量告诉 Git 设置 pull to rebase 而不是 merge（请参阅“branch..rebase“）。当never时，rebase 永远不会自动设置为 true。当local时，对于其他本地分支的跟踪分支，rebase 设置为 true。当remote时，对于跟踪的远程跟踪分支分支，rebase 设置为 true。当always时，对于所有跟踪分支，rebase 将设置为 true。有关如何设置分支以跟踪另一个分支的详细信息，请参阅“branch.autoSetupMerge”。此选项默认为 never。

 branch.sort 

当 git-branch [1] 显示时，此变量控制分支的排序顺序。没有“–sort =”提供的选项，此变量的值将用作默认值。有关有效值，请参阅 git-for-each-ref [1] 字段名称。

 branch.<name>.remote 

当在分支上时，它告诉 git fetch 和 git push 哪个远程提取/推送到。可以使用remote.pushDefault（对于所有分支）覆盖要推送到的远程。对于当前分支，推送到的远程可以被branch.<name>.pushRemote进一步覆盖。如果未配置远程，或者您不在任何分支上，则默认为origin进行提取，remote.pushDefault进行推送。另外，.（一个句点）是当前的本地存储库（一个点存储库），请参阅下面的branch.<name>.merge的最后一个注释。

 branch.<name>.pushRemote 

当在分支上时，它会覆盖branch.<name>.remote以进行推送。它还会覆盖从分支推送的remote.pushDefault。当您从一个地方（例如您的上游）拉出并推送到另一个地方（例如您自己的发布存储库）时，您可能希望设置remote.pushDefault以指定要推送到所有分支的远程，并使用此选项覆盖它对于特定的分支。

 branch.<name>.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 指向所需的分支，并使用相对路径设置.（句点）进行 branch..remote。

 branch.<name>.mergeOptions 

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

 branch.<name>.rebase 

如果为 true，在“git pull”运行时，rebase 分支到已获取的分支之上，而不是从默认远程合并到默认分支。请参阅“pull.rebase”以非特定于分支的方式执行此操作。

当merges时，将--rebase-merges选项传递给 git rebase ，以便本地合并提交包含在 rebase 中（有关详细信息，请参阅 git-rebase [1] ）。

当 perserve 时，也将--preserve-merges传递给 git rebase ，以便通过运行 git pull 不会使本地提交的合并提交变平。

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

注：这可能是危险的操作;不要使用它，除非你理解其含义（详见 git-rebase [1] ）。

 branch.<name>.description 

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

 browser.<tool>.cmd 

指定用于调用指定浏览器的命令。在 shell 中使用作为参数传递的 URL 计算指定的命令。 （参见 git-web {litdd}浏览[1] 。）

 browser.<tool>.path 

覆盖可用于浏览 HTML 帮助的给定工具的路径（参见 git-help [1] 中的-w选项）或 gitweb 中的工作存储库（参见 git-instaweb [ 1] ）。

 checkout.defaultRemote 

当你运行 git checkout 并且只有一个远端时，它可能隐含地退回检查和跟踪，例如 origin/ 。一旦你有超过一个带有的远程引用时，这就会停止工作。此设置允许设置首选远程的名称，该名称在消除歧义时应始终获胜。典型的用例是将其设置为origin。

目前，它被git-checkout [1] 使用，当 git checkout 时，将在另一个远端上检出 分支，而 git-worktree [1] 当 git worktree add 指的是一个远程分支。此设置可能会在将来用于其他类似 checkout 的命令或功能。

 checkout.optimizeNewBranch 

当使用稀疏检出时，用于优化“git checkout -b <new_branch>”的性能。设置为 true 时，git 不会根据当前的稀疏检出设置更新 repo。这意味着它不会更新索引中的 skip-worktree 位，也不会在工作目录中添加/删除文件以反映当前的稀疏检出设置，也不会显示本地更改。

 clean.requireForce 

一个布尔值会使 git-clean 无效，除非给出-f，-i 或-n，默认为 true。

 color.advice 

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

 color.advice.hint 

使用自定义颜色提示。

 color.blame.highlightRecent 

这可用于根据每行的更改日期为 blame 的元数据着色。

此设置应设置为以逗号分隔的颜色和日期设置列表，以颜色开始和结束，日期应设置为从最旧到最新。如果在给定时间戳之前引入该行，则元数据将根据颜色着色，覆盖较旧的带时间戳的颜色。

而不是绝对时间戳相对时间戳也起作用，例如 2.weeks.ago 适用于 2 周以上的任何事情。

默认为 _ 蓝色，12 个月前，白色，1 个月前，红色 _，颜色为一年以上的所有颜色为蓝色，最近一个月和一年之间的变化保持白色，上个月是红色的。

 color.blame.repeatedLines 

使用自定义颜色作为 git-blame 输出的部分，每行重复元信息（例如提交 ID，作者姓名，日期和时区）。默认为青色。

 color.branch 

一个布尔值在 git-branch [1] 的输出中启用/禁用颜色。可以设置为always，false（或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] 将使用所有补丁的颜色。如果设置为true或auto，则这些命令仅在输出到终端时使用颜色。如果未设置，则使用color.ui的值（默认为auto）。

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

 color.diff.<slot> 

使用自定义颜色进行差异着色。 <slot>指定修补程序的哪个部分使用指定的颜色，并且是context之一（上下文文本 - plain是历史同义词），meta（元信息），frag（Hunk header）， func （hunk 头中的函数），old（删除行），new（添加行），commit（提交头），whitespace（突出显示空格错误），oldMoved （删除行），newMoved（添加行），oldMovedDimmed，oldMovedAlternative，oldMovedAlternativeDimmed，newMovedDimmed，newMovedAlternative newMovedAlternativeDimmed（参见 设置 _- git-diff [1] 中的颜色移动 _ 详情），contextDimmed，oldDimmed，newDimmed，contextBold，oldBold和newBold（详见 git-range-diff [1] ）。

 color.decorate.<slot> 

使用 git log --decorate 输出的自定义颜色。 <slot>分别是本地分支，远程跟踪分支，标签，存储和 HEAD 的branch，remoteBranch，tag，stash或HEAD之一，以及用于移植提交的grafted。

 color.grep 

设置为always时，始终突出显示匹配项。当false（或never）时，永远不会。设置为true或auto时，仅在将输出写入终端时使用颜色。如果未设置，则使用color.ui的值（默认为auto）。

 color.grep.<slot> 

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

 context 

上下文行中不匹配的文本（使用-A，-B或-C时）

 filename 

文件名前缀（不使用-h时）

 function 

功能名称行（使用-p时）

 lineNumber 

行号前缀（使用-n时）

 column 

列号前缀（使用--column时）

 match 

匹配文本（与设置matchContext和matchSelected相同）

 matchContext 

匹配上下文行中的文本

 matchSelected 

匹配所选行中的文本

 selected 

选定行中不匹配的文本

 separator 

一行（:，-和=）之间以及之间的字段之间的分隔符（--）

 color.interactive 

设置为always时，始终使用颜色进行交互式提示和显示（例如“git-add --interactive”和“git-clean --interactive”使用的颜色）。如果为假（或never），则永远不会。设置为true或auto时，仅在输出到终端时使用颜色。如果未设置，则使用color.ui的值（默认为auto）。

 color.interactive.<slot> 

使用自定义颜色 git add --interactive 和 git clean --interactive 输出。 <slot>可以是prompt，header，help或error，用于交互式命令的四种不同类型的正常输出。

 color.pager 

在寻呼机正在使用时启用/禁用彩色输出的布尔值（默认为 true）。

 color.push 

用于启用/禁用推送错误颜色的布尔值。可以设置为always，false（或never）或auto（或true），在这种情况下，颜色仅在错误输出到达终端时使用。如果未设置，则使用color.ui的值（默认为auto）。

 color.push.error 

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

 color.remote 

如果设置，则突出显示行开头的关键字。关键字是“错误”，“警告”，“提示”和“成功”，并且不区分大小写。可以设置为always，false（或never）或auto（或true）。如果未设置，则使用color.ui的值（默认为auto）。

 color.remote.<slot> 

为每个远程关键字使用自定义颜色。 <slot>可以是与相应关键字匹配的hint，warning，success或error。

 color.showBranch 

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

 color.status 

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

 color.status.<slot> 

使用自定义颜色进行状态着色。 <slot>是header（状态消息的标题文本），added或updated（已添加但未提交的文件）之一，changed（已更改但未添加到索引中的文件） ），untracked（未被 Git 跟踪的文件），branch（当前分支），nobranch（显示 _ 无分支 _ 警告的颜色，默认为红色），localBranch或remoteBranch（分支和跟踪信息以状态短格式显示时的本地和远程分支名称）或unmerged（具有未更改的更改的文件）。

 color.transport 

拒绝推送时启用/禁用颜色的布尔值。可以设置为always，false（或never）或auto（或true），在这种情况下，颜色仅在错误输出到达终端时使用。如果未设置，则使用color.ui的值（默认为auto）。

 color.transport.rejected 

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

 color.ui 

此变量确定控制每个命令族颜色使用的变量（如color.diff和color.grep）的默认值。随着更多命令学习配置以设置--color选项的默认值，其范围将扩展。如果您希望 Git 命令不使用颜色，则将其设置为false或never，除非使用其他配置或--color选项明确启用。如果您希望所有不是用于机器消耗的输出使用颜色，将其设置为always，如果您希望此类输出在写入时使用颜色，则将其设置为true或auto（这是 Git 1.8.4 以来的默认设置）终点站。

 column.ui 

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

这些选项控制何时启用该功能（默认为 never ）：

 always 

总是显示在列中

 never 

从不在列中显示

 auto 

如果输出到终端，则显示在列中

这些选项控制布局（默认为 _ 列 _）。如果 always，never 或 auto，则设置任何这些意味着 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] 。当您总是希望在日志消息中保留以注释字符#开头的行时，更改默认值会很有用，在这种情况下您将执行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.<url>.* 

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

 credentialCache.ignoreSIGHUP 

告诉 git-credential-cache-daemon 忽略 SIGHUP，而不是退出。

 completion.commands 

这仅由 git-completion.bash 用于在已完成命令列表中添加或删除命令。通常只完成瓷器命令和一些选择其他命令。您可以在此变量中添加更多以空格分隔的命令。使用 - 对命令进行前缀将从现有列表中删除它。

 diff.autoRefreshIndex 

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

 diff.dirstat 

逗号分隔的--dirstat参数列表，指定 git-diff [1] 和朋友的--dirstat选项的默认行为。可以在命令行上覆盖默认值（使用--dirstat=<param1,param2,...>）。回退默认值（当diff.dirstat未更改时）为changes,noncumulative,3。可以使用以下参数：

 changes 

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

 lines 

通过执行常规的基于行的差异分析来计算 dirstat 数字，并对移除/添加的行数进行求和。（对于二进制文件，计算 64 字节块，因为二进制文件没有自然的线条概念）。这是比changes行为更昂贵的--dirstat行为，但它确实计算文件中重新排列的行与其他更改一样多。结果输出与您从其他--*stat选项获得的输出一致。

 files 

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

 cumulative 

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

 <limit> 

整数参数指定截止百分比（默认为 3％）。贡献低于此百分比变化的目录不会显示在输出中。

示例：以下将计算已更改的文件，同时忽略少于已更改文件总量的 10％的目录，并在父目录中累计子目录计数：files,10,cumulative。

 diff.statGraphWidth 

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

 diff.context 

用生成差异。上下文行而不是默认值 3。此值可由-U 选项覆盖。

 diff.interHunkContext 

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

 diff.external 

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

 diff.ignoreSubmodules 

设置–ignore-submodules 的默认值。请注意，这仅影响 git diff Porcelain，而不影响 git diff-files 等低级 diff 命令。 git checkout 在报告未提交的更改时也会尊重此设置。设置为 _ 所有 _ 禁用 git commit 和 git status 通常显示的子模块摘要，当设置status.submoduleSummary时除非使用–ignore 覆盖它-submodules 命令行选项。 _git 子模块 _ 命令不受此设置的影响。

 diff.mnemonicPrefix 

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

 git diff 

比较索引和工作树;

 git diff HEAD 

比较提交和工作树;

 git diff --cached 

比较 commit 和 index;

 git diff HEAD:file1 file2 

比较对象和工作树实体;

 git diff --no-index a b 

比较两个非 git 的东西（1）和（2）。

 diff.noprefix 

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

 diff.orderFile 

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

 diff.renameLimit 

执行复制/重命名检测时要考虑的文件数;相当于 git diff 选项-l。如果关闭重命名检测，此设置无效。

 diff.renames 

Git 是否以及如何检测重命名。如果设置为“false”，则禁用重命名检测。如果设置为“true”，则启用基本重命名检测。如果设置为“copies”或“copy”，Git 也会检测副本。默认为 true。请注意，这仅影响 git diff Porcelain，如 git-diff [1] 和 git-log [1] ，而不是[等低级命令] git-diff-files [1]](https://git-scm.com/docs/git-diff-files) 。

 diff.suppressBlankEmpty 

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

 diff.submodule 

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

 diff.wordRegex 

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

 diff.<driver>.command 

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

 diff.<driver>.xfuncname 

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