在mac终端修改git用户名和邮箱需明确配置层级:全局用git config --global,本地项目用git config(不加参数),修改后用git config --show-origin验证来源。

在Mac终端里修改Git提交时显示的用户名和邮箱,必须确保改的是当前生效的配置层级(全局或本地),否则commit记录仍会沿用旧信息。
确认当前生效的用户名和邮箱
打开终端,执行以下命令查看当前实际被读取的配置:
【注意:不加 --global 或 --local 参数时,git config user.name 默认读取的是当前仓库的本地配置;若不在任何git仓库中运行,会报错】
cd 到任意一个已初始化的 Git 项目根目录 → 执行 git config user.name → 执行 git config user.email
如果想看全局配置(覆盖所有项目),直接运行:
git config --global user.name
git config --global user.email
方法一:用命令行直接覆盖全局配置
这一步会立刻生效,无需重启终端或重新打开项目:
git config --global user.name "张三"
git config --global user.email "zhangsan@example.com"
替换引号内的内容为你的真实姓名和常用邮箱。邮箱地址将用于 GitHub/GitLab 的 contribution 统计,务必与远程平台注册邮箱一致。
方法二:用编辑器打开 .gitconfig 文件手动修改
全局配置文件默认位于用户主目录下:~/.gitconfig
先让隐藏文件可见:Command + Shift + .
然后在 Finder 中前往「前往」→「前往文件夹」→ 输入 ~ → 回车
找到 .gitconfig 文件,用 VS Code 或 TextEdit 打开
文件中应有类似结构:
[user]
name = 旧名字
email = old@domain.com
把等号右边的内容替换成新值,保存即可。修改后建议立即执行 git config --global --list 验证是否写入成功。
方法三:为特定项目单独设置本地账号(覆盖全局)
适用于同时维护个人和公司项目,避免混用同一套身份信息:
第一步:cd 进入目标项目的根目录(该目录下必须存在 .git 文件夹)
第二步:执行 git config user.name "李四"
第三步:执行 git config user.email "lisi@company.com"
这样设置后,仅此项目 commit 时使用该账号,其他项目仍沿用全局配置。【切记不要加 --global 参数,否则就变成改全局了】
验证修改是否成功
在任意 Git 仓库内执行:
git config --show-origin user.name
git config --show-origin user.email
终端会返回配置项来源路径,例如:
file:/Users/xxx/.gitconfig user.name
file:.git/config user.email
若看到第二行是 .git/config,说明本地配置已生效;若两行都指向 .gitconfig,则本地未覆盖,全局配置正在起作用。











