1. Git配置的三层结构：系统级、全局级与仓库级

第一次接触Git配置时，很多人会被--system、--global、--local这些参数搞得晕头转向。其实这三个层级就像套娃一样，从外到内层层嵌套，每一层都有自己明确的职责范围。

系统级配置（--system）是最大的套娃，影响整台机器上的所有用户。它的配置文件通常藏在/etc/gitconfig（Linux/macOS）或者Git安装目录下的mingw64/etc/gitconfig（Windows）。比如公司IT部门想给所有开发者统一设置代码提交规范，就可以在这里配置。修改它需要管理员权限，就像这样：

# 需要sudo权限 sudo git config --system core.autocrlf input

全局级配置（--global）属于当前用户，配置文件在用户主目录的.gitconfig里。这里适合放个人身份信息和工作偏好：

git config --global user.name "你的名字" git config --global user.email "你的邮箱" git config --global core.editor "code --wait" # 用VSCode作为默认编辑器

仓库级配置（--local）则只针对当前项目，配置存储在项目的.git/config文件里。当某个项目需要特殊设置时（比如用不同的邮箱提交），就在这里配置：

cd my-project/ git config --local user.email "special_email@company.com"

2. 配置的优先级与覆盖规则

Git配置的优先级遵循"就近原则"：内层配置会覆盖外层配置。就像你在公司穿工装（全局配置），但参加特定会议时会换正装（本地配置）一样。

这个覆盖顺序是：仓库级 > 全局级 > 系统级。举个例子：

1. 系统级设置了core.autocrlf=true
2. 全局级覆盖为core.autocrlf=input
3. 仓库级又覆盖为core.autocrlf=false

最终在这个仓库里，core.autocrlf的值会是false。查看完整配置时，可以用这个命令看到所有配置及其来源：

git config --list --show-origin

实际工作中遇到过这样的坑：某次提交突然用了错误的邮箱，排查发现是因为在项目目录下误操作了--local配置。这时候需要检查各级配置：

# 查看系统级配置 git config --system --list # 查看全局配置 git config --global --list # 查看当前仓库配置 git config --local --list

3. 配置文件的手动编辑技巧

虽然git config命令很方便，但直接编辑配置文件有时更高效。各层级配置文件的位置如下：

配置文件采用INI格式，可以手动添加复杂配置。比如设置别名（alias）时，直接编辑比命令行更方便：

[alias] st = status ci = commit br = branch co = checkout df = diff lg = log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit

特别注意：修改配置文件后不需要重启Git，更改会立即生效。如果同时存在命令行配置和手动编辑，最后修改的版本会生效。

4. 常用配置项实战指南

4.1 用户身份配置

这是最基本的配置，建议全局设置：

git config --global user.name "你的姓名" git config --global user.email "工作邮箱"

邮箱的坑：很多公司的GitLab会检查提交邮箱是否与账号匹配。如果遇到权限问题，先检查邮箱是否配置正确。

4.2 换行符处理

跨平台协作时，换行符是个大坑。推荐这样设置：

# Windows用户 git config --global core.autocrlf true # Linux/macOS用户 git config --global core.autocrlf input

4.3 提高命令行效率的配置

# 命令输出带颜色 git config --global color.ui auto # 设置常用别名 git config --global alias.st status git config --global alias.ci commit git config --global alias.br branch git config --global alias.co checkout # 输入时自动补全（需要bash-completion） git config --global help.autocorrect 1

4.4 差异比较工具配置

配置Beyond Compare作为diff工具：

git config --global diff.tool bc git config --global difftool.bc.path "/usr/local/bin/bcomp" git config --global difftool.prompt false

5. 排查配置问题的技巧

当Git行为异常时，按这个顺序排查：

1. 用git config --list --show-origin查看生效配置
2. 检查是否有环境变量覆盖（如GIT_AUTHOR_EMAIL）
3. 临时清空配置测试：

   GIT_CONFIG_NOSYSTEM=1 git --git-dir=/tmp/test git config --list

一个真实案例：某次git push总是报认证失败，最后发现是因为项目目录下的.git/config里写死了旧的gitlab地址，而全局配置是新地址。这就是本地配置覆盖全局配置的典型例子。

6. 高级配置场景

6.1 条件配置

Git 2.13+支持根据目录条件加载配置。比如在家用电脑和工作电脑使用不同配置：

[includeIf "gitdir:~/work/"] path = ~/work/.gitconfig

6.2 多账号管理

通过SSH配置和条件配置实现：

# ~/.ssh/config Host work-github HostName github.com User git IdentityFile ~/.ssh/work_id_rsa Host personal-github HostName github.com User git IdentityFile ~/.ssh/personal_id_rsa

然后在项目目录的.git/config中指定：

[remote "origin"] url = git@work-github:company/project.git

6.3 钩子全局管理

把钩子脚本放在统一目录，然后全局配置：

git config --global core.hooksPath ~/.git-hooks

7. 配置的导入导出

备份全局配置：

cp ~/.gitconfig ~/.gitconfig.bak

迁移配置到新机器：

# 导出 git config --global --list > git_config_backup.txt # 导入 while read line; do git config --global $line; done < git_config_backup.txt

对于团队项目，可以把通用配置放在仓库的.gitconfig文件中，然后让成员通过include引入：

[include] path = ../.gitconfig