在使用 Git 进行版本控制时，每一次代码提交（commit）都会记录提交者的身份信息。这些信息不仅用于追踪代码变更历史，还在团队协作、代码审查和开源贡献中发挥着重要作用。
Git 通过 用户名（user.name） 和 邮箱（user.email） 来标识开发者身份。正确配置这两项信息，是使用 Git 的第一步，也是确保提交记录清晰、可追溯的关键。
为什么需要设置用户名和邮箱？
Git 是一个分布式版本控制系统，它不依赖中央服务器来管理用户身份。因此，每个开发者必须在本地明确声明自己的身份。Git 会在每次执行 git commit 时，自动将 user.name 和 user.email 写入提交记录。
如果没有正确设置，可能会导致提交记录显示为 unknown 或默认系统用户名，无法与 GitHub/GitLab 等平台账号关联，团队协作中也难以追溯代码来源，甚至导致开源项目贡献不被认可。所以，首次安装 Git 后，首要任务就是配置用户名和邮箱。
配置 Git 用户名和邮箱
Git 提供了两种配置级别：全局配置 和 本地（仓库级）配置。
全局配置（推荐）
全局配置适用于当前用户在本机上的所有 Git 仓库。这是最常用、最推荐的方式，尤其适合个人开发者或统一身份的场景。
# 设置用户名
git config --global user.name "Your Name"
# 设置邮箱
git config --global user.email "[email protected]"
这里使用 --global 参数表示'全局配置'，配置信息将保存在用户主目录下的 .gitconfig 文件中（路径通常为 ~/.gitconfig）。用户名建议使用真实姓名或统一昵称，便于识别；邮箱建议使用你注册代码托管平台（如 GitHub、GitLab、Gitee）的邮箱，确保提交记录能正确关联到你的账号。
本地配置（按项目设置）
如果你需要为某个特定项目使用不同的身份（例如：工作项目使用公司邮箱，个人项目使用个人邮箱），可以在该项目目录下进行本地配置。
# 进入目标 Git 仓库目录
cd /path/to/your/project
# 设置该项目的用户名（不加 --global）
git config user.name "Project User"
# 设置该项目的邮箱
git config user.email "[email protected]"
该配置仅对当前仓库生效，信息保存在仓库目录下的 .git/config 文件中。值得注意的是，本地配置的优先级高于全局配置，这意味着如果同一个仓库同时存在两者，Git 会优先读取本地配置。
查看当前配置
配置完成后，建议验证设置是否生效。
查看所有配置
git config --list
输出示例中应包含你的用户名和邮箱信息，例如 user.name=Your Name 和 [email protected]。
查看特定配置
# 查看用户名
git config user.name
# 查看邮箱
git config user.email
