本文详细介绍 Git 配置用户名和邮箱的两种方式（全局配置、单仓库配置），包含命令、验证方法及常见问题，可直接作为开发文档使用。
一、核心概念
user.name：提交代码时显示的用户名（建议使用 GitHub/GitLab 用户名）
user.email：提交代码时关联的邮箱（必须与代码托管平台邮箱一致，才能统计提交记录）
配置分为全局配置（所有仓库生效）和本地配置（仅当前仓库生效）
二、全局配置（推荐）
全局配置后，电脑上所有 Git 仓库都会使用该用户名和邮箱，无需重复配置。
配置命令
打开 Git Bash/Terminal/CMD，执行以下命令：配置全局用户名（替换为你的用户名）
git config --global user.name "你的用户名"
配置全局邮箱（替换为你的邮箱）
git config --global user.email "你的邮箱地址"
示例：
git config --global user.name "zhangsan"
git config --global user.email "zhangsan@example.com"
查看全局配置
查看所有全局配置
git config --global --list
单独查看用户名/邮箱
git config --global user.name
git config --global user.email
三、单仓库配置（仅当前项目生效）
适用于多账号场景（如：公司仓库用工作邮箱，个人仓库用私人邮箱），仅对当前打开的仓库生效。
配置步骤
进入目标 Git 仓库目录
执行不带 --global 的命令：配置当前仓库用户名
git config user.name "仓库专属用户名"
配置当前仓库邮箱
git config user.email "仓库专属邮箱"
查看本地配置
查看当前仓库所有配置
git config --local --list
单独查看
git config user.name
git config user.email
四、验证配置是否生效
执行以下命令，输出对应信息即配置成功：
查看当前生效的配置（全局+本地合并结果）
git config --list
五、修改 / 删除配置
修改配置
直接重新执行配置命令即可覆盖原有配置：修改全局用户名
git config --global user.name "新用户名"
删除配置
删除全局用户名
git config --global --unset user.name
删除本地邮箱
git config --local --unset user.email
六、常见问题
配置不生效？
检查命令是否漏写 --global
确认当前终端处于正确的仓库目录
提交代码不显示头像？
邮箱必须与 GitHub/GitLab 绑定的邮箱完全一致
多账号如何区分？
公共仓库用全局配置
特殊仓库用本地配置（优先级高于全局）
七、配置文件位置
全局配置文件：C:\Users\你的用户名.gitconfig（Windows） | ~/.gitconfig（Mac/Linux）
本地配置文件：仓库目录/.git/config
总结
全局配置（所有仓库）：git config --global user.name/email
本地配置（单仓库）：git config user.name/email
验证配置：git config --list
优先级：本地配置 > 全局配置
