git@gitee.com: Permission denied (publickey). fatal: 无法读取远程仓库

错误信息：

git@gitee.com: Permission denied (publickey).
fatal: 无法读取远程仓库。  

说明 Git 无法通过 SSH 密钥成功连接到 Gitee（码云）仓库。这通常是由于 SSH 密钥未正确配置或未添加到 Gitee 账户所致。 

一、解决步骤

1. 检查是否已有 SSH 密钥

在终端中执行以下命令，查看是否存在 SSH 密钥：

ls ~/.ssh/id_rsa.pub

•	如果文件存在，表示已有 SSH 密钥，可跳至步骤 3。
•	如果文件不存在，需要生成新的 SSH 密钥。 

2. 生成新的 SSH 密钥

在终端中执行以下命令，生成新的 SSH 密钥对：

ssh-keygen -t rsa -C "your_email@example.com"

按照提示操作，按回车键接受默认设置，直到生成完成。 

3. 添加公钥到 Gitee 账户

执行以下命令，复制公钥内容：

cat ~/.ssh/id_rsa.pub

登录 Gitee，进入 SSH 公钥管理页面，点击“添加公钥”，将复制的内容粘贴到“公钥”文本框中，填写标题后保存。

4. 测试 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.com
  HostName gitee.com
  User git
  IdentityFile ~/.ssh/id_rsa

确保 IdentityFile 路径正确指向你的私钥文件。

按照上述步骤操作后，应该可以解决连接 Gitee 仓库时的权限问题。如果问题仍然存在，建议检查本地 Git 配置或 Gitee 仓库的访问权限设置。