Git全局用户配置用于自动标识所有仓库的提交作者,避免未知用户错误;通过git config --global user.name/email设置,支持项目级覆盖。

在 Git 中设置全局用户身份信息,是为了让每次提交(commit)自动带上你的名字和邮箱,避免出现 author info not set 错误或提交记录显示为未知用户。Global-User 指的是对当前系统所有仓库都生效的默认配置,无需逐个仓库重复设置。
查看当前全局用户配置
运行以下命令,检查是否已设置,以及当前值是什么:
git config --global user.namegit config --global user.email
如果没输出,说明尚未设置;如果有输出但信息不正确,可继续下一步修改。
设置或更新全局用户名和邮箱
使用 --global 参数一次性配置,后续所有新初始化或克隆的仓库都会继承该配置:
git config --global user.email "your.email@example.com"
注意:
- 名字建议用真实姓名或常用昵称,双引号可省略(无空格时),但含空格务必加引号;
- 邮箱应与你使用的代码托管平台(如 GitHub、GitLab)注册邮箱一致,否则提交可能无法关联到个人主页;
- 设置后不会影响已存在的本地仓库的已有提交,只作用于之后的新提交。
验证设置是否生效
可以新建一个测试目录,初始化仓库并做一次提交,然后查看提交作者信息:
mkdir test-repo && cd test-repogit init
echo "# test" > README.md && git add . && git commit -m "init"
git log --pretty=format:"%an — %s"
输出中应显示你刚设置的姓名和邮箱。
特殊情况:某个项目需单独设置(覆盖全局)
若某仓库需要不同身份(例如公司项目用企业邮箱),可在该仓库根目录下执行不带 --global 的命令:
- git config user.name "Work Name"
- git config user.email "work@company.com"
这样会写入该仓库的 .git/config,优先级高于全局配置,不影响其他项目。


















