git config - 技术栈

文章目录

1.简介
2.格式
3.选项
4.示例
参考文献

1.简介

安装完 Git 后，需要对 Git 环境进行一次配置，且只需要配置一次。程序升级时会保留配置信息。你可以在任何时候再次通过运行命令来修改它们。

Git 自带一个 git config 的工具来设置控制 Git 外观和行为的配置变量，这些变量按照不同的作用级别默认存储在四个不同的文件中。可以使用 --file 选项来显示指明配置文件的路径。

文件路径	级别	说明
/etc/gitconfig	系统级别	包含系统上每一个用户及他们仓库的通用配置。如果使用带有 --system 选项 Git 会读写此文件
~/.config/git/config	用户级别	针对当前用户。使用 --global 选项 Git 会读写此文件
~/.gitconfig	用户级别	针对当前用户。使用 --global 选项 Git 会读写此文件。较新版本的 Git 会使用此配置文件
仓库目录/.gitconfig	仓库级别	对当前仓库有效。使用 --local 选项 Git 会读写此文件，为默认选项

从下到上，每一个级别会覆盖上一级别的配置，优先级如下：

shell 复制代码

仓库目录/.git/config > ~/.gitconfig > /etc/gitconfig

2.格式

shell 复制代码

git config [<options>]

3.选项

shell 复制代码

配置文件路径（Config file location）
--system
	使用系统级别的配置文件
--global
	使用当前用户全局配置文件
--local
	使用当前仓库的配置文件，为默认选项
-f, --file=<file>
	显示指定配置文件路径

动作（Action）
-l, --list
	列出所有配置
--unset
	从配置文件中删除变量名匹配的某一行
--unset-all
	从配置文件中删除变量名匹配的所有行

4.示例

配置用户信息。

当安装完 Git 应该做的第一件事就是设置你的用户名称与邮件地址。

这样做很重要，因为每一个 Git 的提交都会使用这些信息，并且它会写入到你的每一次提交中。

shell 复制代码

git config --global user.name "John Doe"
git config --global user.email "johndoe@example.com"

配置文本编辑器。

当 Git 需要你输入信息时会调用文本编辑器。如果未配置，Git 会使用操作系统默认的文本编辑器，通常是 Vim。如果你想使用不同的文本编辑器，例如 Emacs，可以这样做：

shell 复制代码

git config --global core.editor emacs

让 Git 记住用户名和密码。

每次使用 HTTP 协议与 Git 远端交互时均需要输入用户名和密码，为了避免如此繁琐的操作，可以使用 Git 凭证系统来处理这个事情。下面有一些 Git 的选项：

（1）默认所有都不缓存。每一次连接都会询问你的用户名和密码。

（2）cache 模式会将凭证存放在内存中一段时间。密码永远不会被存储在磁盘中，并且在15分钟后从内存中清除。

（3）store 模式会将凭证用明文的形式存放在磁盘中，并且永不过期。这意味着除非你修改了你在 Git 服务器上的密码，否则你永远不需要再次输入你的凭证信息。这种方式的缺点是你的密码是用明文的方式存放在你的 home 目录下。

（4）如果你使用的是 Mac，Git 还有一种 osxkeychain 模式，它会将凭证缓存到你系统用户的钥匙串中。这种方式将凭证存放在磁盘中，并且永不过期，但是是被加密的，这种加密方式与存放 HTTPS 凭证以及 Safari 的自动填写是相同的。

（5）如果你使用的是 Windows，你可以安装一个叫做 Git Credential Manager for Windows 的辅助工具。这和上面说的 osxkeychain 十分类似，但是是使用 Windows Credential Store 来控制敏感信息。可以在 here 下载。

其中部分辅助工具有一些选项。如 store 模式可以接受一个 --file <path> 参数，可以自定义存放密码的文件路径（默认 ~/.git-credentials ）。cache 模式有 --timeout <seconds> 参数，可以设置凭证存放在内存的存活时间（默认是 900，也就是 15 分钟）。

shell 复制代码

# 设置记住密码（默认15分钟）
git config --global credential.helper cache

# 设置记住密码，自定义有效时长，比如一小时后失效
git config --global credential.helper 'cache --timeout=3600'

# 长期存储用户名和密码
git config --global credential.helper store

# 长期存储用户名和密码，指定用户名密码存储位置
git config --global credential.helper 'store --file ~/.git-credentials'

# 不记住用户名密码，以 HTTP 协议的 clone、pull、push 等每次请求，都需要输入用户名和密码
git config --global --unset credential.helper

如果变更了用户名或密码，只需要清除存放密码的文件（默认 ~/.git-credentials ），会提示重新输入。

协议替换

当你想去克隆一个别人 Github 上的 repository 时，如果使用 HTTPS 协议无法访问，那么可以变更协议采用 SSH 来访问。除了在 clone 时显示变更协议，我们也可以通过配置，让 git 自动进行协议替换。

例如将 HTTPS 协议变更为 SSH 协议。

shell 复制代码

git config --global url."git@github.com:".insteadOf "https://github.com/"

一顿操作之后，你的 .gitconfig 中会多出一行参数设置：

shell 复制代码

[url "git@github.com:"]
	insteadOf = https://github.com/

设置之后，使用 git 进行 clone 时，资源 url 中协议和域名部分https://github.com/将被替换为git@github.com:。

core.autocrlf 的配置。

shell 复制代码

# 提交时转换为 LF，检出时转换为 CRLF
git config --global core.autocrlf true   

# 提交时转换为 LF，检出时不转换
git config --global core.autocrlf input

# 提交检出均不转换
git config --global core.autocrlf false

一般 Windows IDE 会将换行改为 CRLF，所以建议设置为第二种，提交时转换为 LF，检出时不转换。

查看配置信息。

使用git config -l, --list命令可以列出 Git 当前所有配置。

shell 复制代码

git config -l
user.name=John Doe
user.email=johndoe@example.com
color.status=auto
color.branch=auto
color.interactive=auto
color.diff=auto
...

或者通过输入 git config <key> 或git config --get <key>来检查 Git 的某一项配置。

shell 复制代码

git config user.name
John

git config --get user.email
John@tencent.com

参考文献

git config