git@gitee.com: Permission denied (publickey). fatal: 无法读取远程仓库
错误信息:
git@gitee.com: Permission denied (publickey).
fatal: 无法读取远程仓库。  
说明 Git 无法通过 SSH 密钥成功连接到 Gitee(码云)仓库。这通常是由于 SSH 密钥未正确配置或未添加到 Gitee 账户所致。 
一、解决步骤
- 检查是否已有 SSH 密钥
在终端中执行以下命令,查看是否存在 SSH 密钥:
ls ~/.ssh/id_rsa.pub
• 如果文件存在,表示已有 SSH 密钥,可跳至步骤 3。
• 如果文件不存在,需要生成新的 SSH 密钥。 
- 生成新的 SSH 密钥
在终端中执行以下命令,生成新的 SSH 密钥对:
ssh-keygen -t rsa -C "your_email@example.com"
按照提示操作,按回车键接受默认设置,直到生成完成。 
- 添加公钥到 Gitee 账户
执行以下命令,复制公钥内容:
cat ~/.ssh/id_rsa.pub
登录 Gitee,进入 SSH 公钥管理页面,点击“添加公钥”,将复制的内容粘贴到“公钥”文本框中,填写标题后保存。
- 测试 SSH 连接
在终端中执行以下命令,测试与 Gitee 的 SSH 连接:
ssh -T git@gitee.com
如果配置正确,应该看到类似以下的提示:
Welcome to Gitee, your_username!
二、其他可能的原因及解决方法
- SSH 代理未启动或未添加密钥
如果使用了 SSH 代理(如 ssh-agent),需要确保代理正在运行,并已添加私钥:
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_rsa
- SSH 配置文件问题
如果使用了多个 SSH 密钥,建议配置 ~/.ssh/config 文件,指定 Gitee 使用的密钥:
Host gitee.comHostName gitee.comUser gitIdentityFile ~/.ssh/id_rsa
确保 IdentityFile 路径正确指向你的私钥文件。
按照上述步骤操作后,应该可以解决连接 Gitee 仓库时的权限问题。如果问题仍然存在,建议检查本地 Git 配置或 Gitee 仓库的访问权限设置。