解决 GitHub 克隆项目时出现 “Permission denied (publickey)” 问题

AHumanBeing

于 2025-05-02 09:32:01 发布

阅读量630

点赞数 8

分类专栏： Github 文章标签： github

本文链接：https://blog.csdn.net/AHumanBeing/article/details/147659767

版权

Github 专栏收录该内容

1 篇文章

订阅专栏

今天用git下载github上的代码出现了如下报错：
在这里插入图片描述

解决 GitHub 克隆项目时出现 “Permission denied (publickey)” 问题

在使用 Git 从 GitHub 克隆项目时，我们可能会遇到以下错误：

$ git clone git@github.com:coze-dev/coze-js.git
Cloning into 'coze-js'...
git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

这个错误通常是因为 SSH 密钥配置问题导致的。本文将详细介绍如何解决这个问题，帮助您顺利克隆项目。

一、问题原因分析

出现这个错误的原因主要有以下几种：

SSH Key 未生成：本地客户端尚未生成 SSH Key，因此无法通过 SSH 方式与 GitHub 进行通信。
SSH Key 未添加到 GitHub：虽然本地生成了 SSH Key，但未将其公钥添加到 GitHub 的账户设置中。
SSH Key 不匹配：本地的 SSH Key 与 GitHub 上的公钥不匹配，可能是由于更换了设备或重新生成了 SSH Key。
GitHub 账号权限问题：您可能没有权限访问该仓库，或者仓库不存在。

二、解决步骤

1. 检查是否已生成 SSH Key

在命令行中输入以下命令，检查是否存在 SSH Key：

ls -al ~/.ssh

如果看到类似 id_rsa 和 id_rsa.pub 的文件，说明您已经生成了 SSH Key。如果没有，需要先生成一个新的 SSH Key。

2. 生成新的 SSH Key

如果尚未生成 SSH Key，或者需要重新生成一个新的密钥对，可以按照以下步骤操作：

打开命令行工具（如 Windows 的 Git Bash 或 Mac 的 Terminal）。
输入以下命令，生成新的 SSH Key：
```
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
```
将 your_email@example.com 替换为您在 GitHub 上注册的邮箱地址。
按提示操作，选择保存路径（默认即可），并设置一个密码（可选）。

3. 将公钥添加到 GitHub

打开生成的公钥文件，复制其内容：
```
cat ~/.ssh/id_rsa.pub #cat是查看文件内容的命令
```
将显示的内容复制到剪贴板。
登录到您的 GitHub 账号，点击右上角的头像，选择 Settings。
在左侧菜单栏中，点击 SSH and GPG keys。
点击 New SSH key 按钮，将复制的公钥内容粘贴到 Key 输入框中。
在 Title 输入框中，输入一个描述（如 “My Laptop” 或 “My Desktop”）。
点击 Add SSH key 按钮，完成添加。
最终结果如图所示

4. 验证 SSH Key 配置

在命令行中输入以下命令，验证 SSH Key 是否配置成功：

ssh -T git@github.com

如果配置成功，您会看到类似以下的提示信息：

Hi username! You've successfully authenticated, but GitHub does not provide shell access.

这说明您的 SSH Key 已经成功添加到 GitHub。

5. 重新克隆项目

现在，您可以尝试再次克隆项目：

git clone git@github.com:coze-dev/coze-js.git

如果一切配置正确，项目应该能够顺利克隆到本地。

三、其他注意事项

检查仓库地址是否正确：确保您输入的仓库地址是正确的，尤其是仓库名和用户名部分。
检查仓库权限：如果您没有权限访问该仓库，可以联系仓库的管理员，请求添加访问权限。
使用 HTTPS 克隆：如果您不想配置 SSH Key，也可以使用 HTTPS 方式克隆项目。例如：
```
git clone https://github.com/coze-dev/coze-js.git
```
使用 HTTPS 方式克隆时，您需要输入 GitHub 账号的用户名和密码。