Git仓库配置实战：从身份设置到多账号隔离的完整指南

只要是天天跟代码打交道的人，几乎都遇到过这种场景：明明在自己电脑上提交代码时显示的提交人是对的，换一台新机器，或者从别人那儿克隆了一个仓库下来，一提交，提交记录里冒出来的却是别人的名字，甚至是一串乱码邮箱。问题其实不在仓库本身，而在Git的配置信息。

说到“Git仓库对应的配置信息”，很多人的第一反应是git config user.name和git config user.email，但实际操作起来远没那么简单。Git的配置是分层的，不同层级有不同作用域，还牵扯到换行符、远程地址、SSH密钥、凭据存储，甚至多平台多账号的隔离。这篇文章就把“仓库配置”这条线完整梳理一遍，从原理到实操，从单仓库到多仓库，从正常配置到报错排查，一次性讲透。

1. 先搞清楚Git配置到底存在哪里

1.1 Git配置的三层体系

Git的配置信息不是只有一份，而是分成了三个层级。理解这三个层级，很多玄学问题一下就通了。

• system级别：整台机器上的所有用户共享，配置文件在Git安装目录下的etc/gitconfig。Windows下通常在C:\Program Files\Git\etc\gitconfig，Linux下通常在/etc/gitconfig。这个层级一般只在安装时写入基础信息，日常很少动它。
• global级别：当前操作系统用户专用，配置文件在用户主目录下的.gitconfig。Windows是C:\Users\你的用户名\.gitconfig，Linux和macOS是~/.gitconfig。日常使用中最常改的就是这个。
• local级别：只对当前仓库生效，配置文件就是仓库根目录下的.git/config。这个文件是git init或git clone时自动创建的，也是“创建的Git仓库对应的Git配置信息”最核心的落点。

这三层配置的关系可以类比成公司制度：system相当于国家法律，global相当于公司规定，local相当于你自己工位上贴的便签。越具体的越优先，所以在任意一个仓库里执行git config命令时，最终生效的值是三层配置“就近覆盖”后的结果。

用命令可以分别操作三层配置：

bash复制# system级
git config --system user.name "Your Name"

# global级
git config --global user.name "Your Name"

# local级（仓库内执行，不写--global就是local）
git config user.name "Your Name"

这种分层设计的价值在于灵活性：同一台机器上，可以给个人项目用个人邮箱，给公司项目用企业邮箱，互不干扰。理解了这个机制，后面所有配置操作都有了“地图坐标”。

1.2 用--show-origin查看配置来源

很多人在排查配置问题时，第一反应是执行git config --list看配置项，但这里有个坑：--list会把三层配置合并到一起输出，你根本分不清某个配置到底来自哪个文件。如果user.name被system层错误设置了一个值，而global层没覆盖，你在这台机器上所有仓库的提交人都会是错的。

更实用的命令是加上--show-origin参数：

bash复制git config --list --show-origin

这条命令会告诉你每一行配置来自哪个文件。输出大概是这样的：

text复制file:"C:/Program Files/Git/etc/gitconfig"  core.symlinks=false
file:"C:/Program Files/Git/etc/gitconfig"  core.autocrlf=true
file:"C:/Users/你的用户名/.gitconfig"  user.name=张三
file:"C:/Users/你的用户名/.gitconfig"  user.email=zhangsan@example.com
file:.git/config  core.repositoryformatversion=0
file:.git/config  core.bare=false
file:.git/config  remote.origin.url=https://gitee.com/zhangsan/demo.git

看到最后几行file:.git/config后面的内容，这就是本仓库自己的配置信息。通过--show-origin，你能精准定位每个配置项的“出生地”，排查问题是一抓一个准。

另外，如果想单独看某一条配置，不想看全部，可以指定配置名：

bash复制git config user.name
git config --global user.email
git config --local --list

--local --list这个组合很实用，专门看当前仓库的有效配置，不用被全局配置干扰。我自己的习惯是刚克隆完一个仓库后，先跑一遍git config --local --list，确认仓库自带的配置是否正常，再决定要不要补配置。

2. 仓库创建后必须配齐的核心信息

2.1 提交身份：user.name与user.email

一个仓库如果没有设置user.name和user.email，首次执行git commit时会直接报错：

text复制