解决git@github.com: Permission denied (publickey)

报错结果如下

bash 复制代码
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 密钥

在 PowerShell中执行以下命令,查看是否已经生成过密钥:

bash 复制代码
ls -al ~/.ssh
  • 如果有文件 :看到 id_rsa 和 id_rsa.pub(或 id_ed25519 等),说明密钥已存在,请跳过步骤 2,直接去步骤 3 复制公钥。
  • 如果没有文件:提示"No such file or directory",请继续步骤 2 生成新的密钥。

步骤 2️⃣:生成新的 SSH 密钥

如果检查后发现没有密钥,运行以下命令生成(请将邮箱替换为你自己的 GitHub 邮箱):

bash 复制代码
ssh-keygen -t ed25519 -C "xxx@qq.com"
  • 操作提示
    • 出现 Enter file in which to save the key:直接按 回车 使用默认路径。
    • 出现 Enter passphrase:建议直接回车留空(为了方便免密操作);如果设置了密码,以后每次操作 Git 都会要求输入这个密码。

步骤 3️⃣:将公钥复制到剪贴板

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

  1. 在 Git Bash 中查看公钥内容:

    bash 复制代码
    cat ~/.ssh/id_ed25519.pub

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

  2. 复制 输出的全部内容(从 ssh-ed25519 开始,一直到你的邮箱地址结束)。


步骤 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 认识刚才生成的密钥。

  1. 启动 Agent

    (在 Git Bash 中执行):

    bash 复制代码
    eval "$(ssh-agent -s)"
  2. 添加私钥

    bash 复制代码
    ssh-add ~/.ssh/id_ed25519

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

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

✅ 最终验证

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

bash 复制代码
ssh -T git@github.com
  • 如果看到 Hi username! You've successfully authenticated...,说明配置成功!现在你可以正常进行代码推送了。
相关推荐
dong_junshuai2 小时前
每天一个开源项目#159 Plannotator:把Agent审阅做成异步消息
github
bysking4 小时前
GitHub Actions 快速入门+场景实践案例
前端·后端·github
laoyeye8318 小时前
手写 vLLM 分页 KV Cache(一):先从 Continuous Batching 调度器看全局
github
徐小夕10 小时前
开源!我们用知识图谱重构了电子档案,AI 驱动全文智能关联
前端·vue.js·github
一条Go11 小时前
开源新生代雷达 · 第 13 期
github
一条Go11 小时前
Kubernetes 多集群接入:kubeconfig 只进不出
后端·架构·github
怕浪猫21 小时前
全球 3D 网络地球的实时通信节点,来看看这四种交互地球,满足你对物理互联网的所有好奇
面试·架构·github
wflynn1 天前
GitHub 今日推荐|kiri:clone3 系统调用直达容器,2.5 毫秒启动无 runc 中间层
docker·rust·kubernetes·开源·github·containers
可乐ea1 天前
MCP 和 CLI 差 42 倍:一次 GitHub 任务的上下文成本实测
人工智能·github·工具调用·ai智能体·openrouter·mcp协议·上下文优化
逛逛GitHub1 天前
Claude 最新模型发布 1 周了,瞧瞧外网惊艳到震撼的玩法。
github