推送/拉取第三方Git仓库时无法切换GitHub账号的问题

核心问题说明 #

你遇到的权限错误本质是：Git提交时的user.name/user.email仅控制提交记录的作者信息，和GitHub的身份验证完全无关。真正决定权限的是SSH密钥或HTTPS凭证，你的推送操作默认使用了学校账号的验证信息，所以被拒绝。

正确解决方案 #

方案一：SSH多密钥精准配置（推荐） #

你之前尝试的SSH配置思路正确，但缺少关键步骤，完善后即可生效：

1. 编辑~/.ssh/config文件，确保配置准确并添加IdentitiesOnly yes（强制使用指定密钥，避免默认密钥优先尝试）：

Host github-personal
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519_personal  # 替换为你的个人SSH密钥路径
  IdentitiesOnly yes

Host github-college
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519_college    # 替换为你的学校SSH密钥路径
  IdentitiesOnly yes

2. 将密钥添加到ssh-agent并验证连接

# 清空旧的密钥缓存（可选）
ssh-add -D

# 添加个人和学校密钥
ssh-add ~/.ssh/id_ed25519_personal
ssh-add ~/.ssh/id_ed25519_college

# 验证个人账号连接
ssh -T git@github-personal
# 预期输出：Hi PERSONAL_ACCOUNT! You've successfully authenticated, but GitHub does not provide shell access.

# 验证学校账号连接
ssh -T git@github-college
# 预期输出：Hi COLLEGE_ACCOUNT! You've successfully authenticated, but GitHub does not provide shell access.

3. 修改目标仓库的远程URL
   进入朋友的项目仓库，将远程URL替换为个人账号对应的Host：

git remote set-url origin git@github-personal:FRIEND/REPO.git

之后执行git push origin main或git push --set-upstream origin NEW_BRANCH即可正常推送。

方案二：HTTPS凭证分离（若偏好HTTPS方式） #

如果习惯用HTTPS而非SSH，可通过以下方式区分不同账号的凭证：

1. 全局开启按仓库路径区分凭证

git config --global credential.useHttpPath true

此配置会让Git根据仓库的HTTPS路径（如https://github.com/FRIEND/REPO.git和https://github.com/SCHOOL/REPO.git）分别存储凭证。

2. 针对单个仓库指定凭证存储文件
   进入朋友的项目仓库，设置单独的凭证存储文件：

git config credential.helper store --file ~/.git-credentials-personal

首次推送时输入个人GitHub账号的用户名和访问令牌（Token），后续Git会自动使用该凭证。

为什么之前的操作无效？ #

• 修改user.name/user.email：仅影响提交记录的作者显示，不涉及身份验证，对权限问题无帮助。
• git branch --set-upstream-to：需要远程分支已存在，你尝试时远程无对应分支，自然无效。
• 未添加IdentitiesOnly yes的SSH配置：SSH会优先尝试默认密钥（可能是学校账号的），导致验证身份错误。

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