在使用 Git 进行版本控制时，每一次代码提交（commit）都会记录提交者的身份信息。这些信息不仅用于追踪代码变更历史，还在团队协作、代码审查和开源贡献中发挥着重要作用。
Git 通过 用户名（user.name） 和 邮箱（user.email） 来标识开发者身份。正确配置这两项信息，是使用 Git 的第一步，也是确保提交记录清晰、可追溯的关键。
一、为什么需要设置用户名和邮箱？
Git 是一个分布式版本控制系统，它不依赖中央服务器来管理用户身份。因此，每个开发者必须在本地明确声明自己的身份。Git 会在每次执行 git commit 时，自动将 user.name 和 user.email 写入提交记录。
如果没有正确设置，可能会导致：
- 提交记录显示为 unknown 或默认系统用户名；
- 无法与 GitHub/GitLab 等平台账号关联；
- 团队协作中难以追溯代码来源；
- 开源项目贡献不被认可。
因此，首次安装 Git 后，首要任务就是配置用户名和邮箱。
二、配置 Git 用户名和邮箱
Git 提供了两种配置级别：全局配置 和 本地（仓库级）配置。
1. 全局配置（推荐）
全局配置适用于当前用户在本机上的所有 Git 仓库。这是最常用、最推荐的方式，尤其适合个人开发者或统一身份的场景。
设置命令：
|
1 2 3 4 5 |
# 设置用户名 git config --global user.name "xiaoli"
# 设置邮箱 git config --global user.email "3339059430@qq.com" |
说明：
- --global 参数表示“全局配置”，配置信息将保存在用户主目录下的 .gitconfig 文件中（路径通常为 ~/.gitconfig）。
- 用户名建议使用真实姓名或统一昵称，便于识别。
- 邮箱建议使用你注册代码托管平台（如 GitHub、GitLab、Gitee）的邮箱，确保提交记录能正确关联到你的账号。
2. 本地配置（按项目设置）
如果你需要为某个特定项目使用不同的身份（例如：工作项目使用公司邮箱，个人项目使用个人邮箱），可以在该项目目录下进行本地配置。
操作步骤：
|
1 2 3 4 5 6 7 8 |
# 进入目标 Git 仓库目录 cd /path/to/your/project
# 设置该项目的用户名（不加 --global） git config user.name "Work User"
# 设置该项目的邮箱 git config user.email "work@company.com" |
特点：
- 该配置仅对当前仓库生效。
- 配置信息保存在仓库目录下的 .git/config 文件中。
- 本地配置优先级高于全局配置。
三、查看当前配置
配置完成后，建议验证设置是否生效。
1. 查看所有配置
|
1 |
git config --list |
输出示例：
|
1 2 3 4 |
user.name=xiaoli user.email=3339059430@qq.com core.editor=vim ... |
2. 查看特定配置
|
1 2 3 4 5 |
# 查看用户名 git config user.name
# 查看邮箱 git config user.email |
如果输出为你设置的值（如 xiaoli 和 3339059430@qq.com），则说明配置成功。
四、配置文件存储位置
了解配置文件的存储位置有助于手动编辑或排查问题。
| 配置类型 | 配置文件路径 | 说明 |
|---|---|---|
| 系统级 | /etc/gitconfig | 所有用户共享，使用 --system 参数 |
| 全局级 | ~/.gitconfig 或 ~/.config/git/config | 当前用户所有仓库，使用 --global 参数 |
| 本地级 | .git/config（在仓库根目录） | 当前仓库专用，使用无参数的 git config |
提示：你可以直接用文本编辑器打开这些文件进行查看或修改。
五、最佳实践
推荐做法
- 首次安装 Git 后立即配置全局用户名和邮箱
建议在安装 Git 后第一时间执行以下命令：
|
1 2 |
git config --global user.name "xiaoli" git config --global user.email "3339059430@qq.com" |
- 邮箱一致性
使用你在 GitHub、GitLab、Gitee 等平台注册的邮箱，确保提交记录能正确显示在你的个人主页。 - 使用统一身份
除非有特殊需求（如工作/个人分离），否则建议全局配置一个统一的身份，避免混淆。 - 定期检查配置
尤其是在新设备或新环境上，使用 git config --list 确认身份信息正确。
常见问题与避坑指南
- 问题1：提交后发现邮箱写错了怎么办？
可以使用 git commit --amend 修改最后一次提交的作者信息，或重新配置后后续提交会自动使用新信息。 - 问题2：如何修改已配置的信息？
直接重新执行 git config --global user.name "新名字" 即可覆盖原值。 - 问题3：是否必须使用真实邮箱？
不强制，但建议使用真实邮箱。GitHub 支持使用 隐私邮箱（如 id+github@users.noreply.github.com），既保护隐私又能关联账号。
