Git全局与本地用户配置冲突致推送失败的解决建议

1. 确认并修复本地仓库配置 #

先确保当前项目的本地配置完全覆盖全局（GitHub会关联用户名和邮箱，需同时设置）：

# 进入目标项目根目录
cd /path/to/your/project
# 设置本地仓库专属的用户名和邮箱
git config --local user.name "你的项目用户名"
git config --local user.email "me@projectemail"
# 验证配置来源与优先级，确保本地配置排在全局之前
git config --list --show-origin

执行后，git config --list应显示本地配置来自当前项目的.git/config文件，且邮箱条目在全局邮箱之前。

2. 未提交代码的场景 #

如果还未做任何commit，直接用新配置提交即可：

git add .
git commit -m "提交说明"
git push

3. 已提交代码（历史用了工作邮箱）的场景 #

若已用工作邮箱提交过代码，GitHub会因提交历史的邮箱无权限拒绝push，需修改历史提交的邮箱信息：
在项目根目录执行以下脚本（替换占位符为你的实际信息）：

#!/bin/sh

OLD_EMAIL="me@workemail"
CORRECT_NAME="你的项目用户名"
CORRECT_EMAIL="me@projectemail"

git filter-branch --env-filter '
if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ]
then
    export GIT_COMMITTER_NAME="$CORRECT_NAME"
    export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL"
fi
if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ]
then
    export GIT_AUTHOR_NAME="$CORRECT_NAME"
    export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL"
fi
' --tag-name-filter cat -- --branches --tags

修改完成后，强制推送到远程仓库（--force-with-lease比--force更安全，避免覆盖他人提交）：

git push --force-with-lease origin 你的分支名

4. 后续预防方案 #

为避免重复配置，可在全局.gitconfig（通常路径为~/.gitconfig）中添加条件规则，自动为指定目录下的项目启用非工作邮箱：

[includeIf "gitdir:/path/to/你的非工作项目根目录/"]
    path = ~/.gitconfig-non-work

然后创建~/.gitconfig-non-work文件并写入：

[user]
    name = 你的非工作用户名
    email = me@projectemail

此后所有放在该目录下的仓库都会自动使用非工作邮箱配置。

内容的提问来源于stack exchange，提问作者vogomatix