【保姆级】Git配置用户名和邮箱（全局/局部）解决提交记录不识别、贡献图不亮问题

前言

很多新手安装完 Git 直接拉代码、提代码，最后出现一堆离谱问题：

GitHub/Gitee 提交不统计贡献度，贡献图一片灰
提交记录显示 unknown 陌生用户
多人共用电脑，仓库作者信息混乱
推送代码时报错、身份不匹配

90% 的原因都是：没有正确配置 Git 的 user.name 和 user.email。

今天一文彻底搞定 Git 用户身份配置，包含全局配置、单项目局部配置、查看、修改、删除全套操作，小白直接抄作业！

适合人群：Git 新手、刚装完 Git、提交记录不生效、贡献墙不亮的开发者

一、核心原理（必看）

Git 每次 commit 提交都会永久记录作者用户名+邮箱。

GitHub / Gitee / GitLab 是通过邮箱匹配账号的：

✅ 邮箱和平台注册邮箱一致 → 识别为本人、统计贡献、点亮绿墙

❌ 邮箱不一致 → 识别为陌生人、不统计贡献、提交记录不归属

二、全局配置（推荐✅ 99% 开发者使用）

全局配置：本机所有 Git 项目统一生效，一次配置、永久使用。

打开 Git Bash，执行以下两条命令，替换为自己的账号信息即可：

bash 复制代码

git config --global user.name "你的Git用户名"
git config --global user.email "你的GitHub/Gitee注册邮箱"

参数解释

--global：全局参数，对电脑所有 Git 仓库生效
user.name：自定义 Git 提交显示用户名（任意合法昵称）
user.email：必须和 Gitee/GitHub 注册邮箱一致

三、单项目局部配置（进阶）

适用场景：一台电脑切换多个 Git 账号（公司账号+个人账号）。

进入具体项目根目录 ，不带 --global，仅当前项目生效：

bash 复制代码

# 当前项目单独配置用户名邮箱
git config user.name "你的项目用户名"
git config user.email "你的项目专用邮箱"

优先级：局部配置 > 全局配置

四、验证配置是否成功

配置完成后，一定要校验，避免输错！

bash 复制代码

# 查看全局用户名
git config --global user.name

# 查看全局邮箱
git config --global user.email

正确输出：

plain 复制代码

你的Git用户名
你的GitHub/Gitee注册邮箱

查看全部 Git 配置：

bash 复制代码

git config --list

五、修改 / 删除配置

1. 修改配置

直接重新执行配置命令即可覆盖旧配置，无需删除。

2. 删除全局配置

bash 复制代码

git config --global --unset user.name
git config --global --unset user.email

3. 删除当前项目局部配置

bash 复制代码

git config --unset user.name
git config --unset user.email

六、常见踩坑总结（高频问题）

Q1：配置后之前的提交记录会变吗？

不会。新配置只对后续新提交生效，历史提交作者信息不变。

Q2：贡献图不亮、不统计贡献？

99% 是邮箱不匹配！务必保证 git config 邮箱 == 平台账号邮箱。

Q3：用户名可以随便写吗？

可以，用户名仅展示用，邮箱必须精准匹配。

七、完整一键配置总结

新手直接全套复制粘贴：

bash 复制代码

# 全局身份配置（自行替换个人信息）
git config --global user.name "你的Git用户名"
git config --global user.email "你的GitHub/Gitee注册邮箱"

# 校验配置
git config --global user.name
git config --global user.email

写在最后

Git 用户名邮箱配置是入门必配操作，看似简单，却是绝大多数人踩坑的重灾区。配置正确后，代码提交归属、贡献统计、远程仓库协作都会完全正常。

后续会更新 Git 免密配置、多账号切换、SSH 配置、历史提交修改等教程，需要的可以点赞+关注！

有问题评论区留言，秒回解答！