Git 连接 GitHub 出现权限拒绝错误的解决方案

报错结果如下：

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.

适用场景：在 Git Bash 中执行 git push / git pull / git clone 时提示权限被拒绝。

核心原理：配置 SSH 密钥，让 GitHub 识别你的电脑。

步骤 1：检查本地是否已有 SSH 密钥

在终端中执行以下命令，查看是否已经生成过密钥：

ls -al ~/.ssh

• 如果有文件：看到 id_rsa 和 id_rsa.pub（或 id_ed25519 等），说明密钥已存在，请跳过步骤 2，直接去步骤 3 复制公钥。
• 如果没有文件：提示 "No such file or directory"，请继续步骤 2 生成新的密钥。

步骤 2：生成新的 SSH 密钥

如果检查后发现没有密钥，运行以下命令生成（请将邮箱替换为你自己的 GitHub 邮箱）：

ssh-keygen -t ed25519 -C "[email protected]"

• 操作提示
  • 出现 Enter file in which to save the key：直接按 回车 使用默认路径。
  • 出现 Enter passphrase：建议 直接回车留空（为了方便免密操作）；如果设置了密码，以后每次操作 Git 都会要求输入这个密码。

步骤 3：将公钥复制到剪贴板

我们需要把公钥（.pub 文件）的内容发给 GitHub。

复制输出的全部内容（从 ssh-ed25519 开始，一直到你的邮箱地址结束）。

在 Git Bash 中查看公钥内容：

cat ~/.ssh/id_ed25519.pub

(如果是 RSA 密钥，请输入 cat ~/.ssh/id_rsa.pub)

步骤 4：在 GitHub 上添加 SSH Key

1. 登录 GitHub，点击右上角头像 -> Settings。
2. 点击左侧菜单的 SSH and GPG keys。
3. 点击 New SSH key 按钮。
4. Title 填写一个名字（例如：My Windows PC）。
5. Key 粘贴刚才复制的公钥内容。
6. 点击 Add SSH key 保存。

步骤 5：启动 SSH Agent 并添加私钥

这一步是让 Git Bash 认识刚才生成的密钥。

• 如果提示 Identity added，说明成功了。

添加私钥：

ssh-add ~/.ssh/id_ed25519

(如果是 RSA 密钥，请输入 ssh-add ~/.ssh/id_rsa)

启动 Agent（在 Git Bash 中执行）：

eval "$(ssh-agent -s)"

最终验证

在 Git Bash 中输入以下命令测试连接：

ssh -T [email protected]

• 如果看到 Hi username! You've successfully authenticated...，说明 配置成功！现在你可以正常进行代码推送了。