将Git远程仓库URL从HTTPS切换为SSH后遇问题求助

1. 检查并修正远程仓库地址 #

先确认当前远程仓库的协议是否正确切换为SSH：

git remote -v

如果输出里的origin不是SSH格式（如git@github.com:用户名/仓库名.git），重新设置远程地址：

git remote set-url origin git@github.com:用户名/仓库名.git

替换成你实际的SSH仓库地址。

2. 验证SSH密钥配置 #

这个错误大多是SSH密钥未正确配置导致的，按以下步骤排查：

• 查看本地是否存在SSH密钥对：

  ls -la ~/.ssh
  

  若没有id_rsa（私钥）和id_rsa.pub（公钥）文件，生成新密钥：

  ssh-keygen -t rsa -b 4096 -C "你的邮箱@example.com"
  

  全程按回车使用默认设置即可。
• 将公钥内容复制到远程仓库平台（GitHub/GitLab等）的SSH密钥列表：
  打印公钥内容：

  cat ~/.ssh/id_rsa.pub
  

  登录平台账号，进入设置页面找到SSH Keys选项，粘贴公钥内容并保存。
• 测试SSH连接是否正常：

  ssh -T git@github.com
  

  GitLab用户替换为git@gitlab.com，出现欢迎提示则说明连接正常。

3. 确认本地Git用户配置 #

确保本地Git的用户名和邮箱与远程平台账号一致：

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱@example.com"

4. 重新执行提交推送 #

先拉取远程最新代码避免冲突：

git pull origin 你的分支名

再执行提交和推送操作：

git add .
git commit -m "提交说明"
git push origin 你的分支名

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