ssh连接github失败需检查密钥：一、检查~/.ssh目录是否存在id_rsa等文件；二、用powershell或git bash生成ed25519或rsa密钥；三、启动ssh-agent并添加私钥；四、复制公钥添加至github；五、执行ssh -t git@github.com测试。
如果您尝试通过SSH协议与GitHub进行安全通信，但连接失败或提示权限被拒绝，则可能是由于本地未生成SSH密钥或公钥未正确添加到GitHub账户。以下是完成Git SSH密钥生成与配置的完整操作步骤：
一、检查是否已存在SSH密钥
Windows系统可能已存在旧的SSH密钥对，重复生成可能导致冲突或覆盖关键凭据。需先确认~/.ssh/目录下是否存在id_rsa与id_rsa.pub等默认密钥文件。
1、按Win + R打开运行窗口，输入cmd并回车启动命令提示符。
2、在命令行中执行：dir %USERPROFILE%\.ssh。
3、若返回“找不到文件”或目录为空，则表示尚未生成密钥；若列出id_rsa和id_rsa.pub，可跳过生成步骤直接进入配置环节。
二、使用OpenSSH生成新的SSH密钥对
Windows 10 1809及更高版本内置OpenSSH客户端，无需额外安装Git Bash即可完成密钥生成，该方法依赖系统原生工具，兼容性高且路径管理清晰。
1、以管理员身份运行PowerShell（右键开始菜单 → 选择“Windows PowerShell（管理员）”）。
2、执行命令：ssh-keygen -t ed25519 -C "your_email@example.com"，将your_email@example.com替换为GitHub注册邮箱。
3、按提示输入保存路径（直接回车使用默认%USERPROFILE%\.ssh\id_ed25519）。
4、设置密钥密码（passphrase），可直接回车留空（不推荐），或输入至少4位以上含字母与数字的强密码。
三、使用Git Bash生成SSH密钥对
Git for Windows自带Git Bash环境，提供类Linux终端体验，适合习惯Unix风格命令的用户，其ssh-keygen行为与Linux一致，支持更多算法选项。
1、从开始菜单启动Git Bash。
2、执行命令：ssh-keygen -t rsa -b 4096 -C "your_email@example.com"，邮箱需与GitHub账户一致。
3、按提示指定密钥保存位置（建议保持默认~/.ssh/id_rsa）。
在 Windows 上执行终端命令，或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe，再给出相应命令……
4、输入两次密钥密码，系统将生成私钥id_rsa与公钥id_rsa.pub。
四、启动SSH代理并添加私钥
SSH代理负责在会话中缓存解密后的私钥，避免每次Git操作都重复输入密码，确保连接流程自动化且安全。
1、在Git Bash或PowerShell中执行：eval "$(ssh-agent -s)"，启动代理进程。
2、执行：ssh-add ~/.ssh/id_ed25519（若使用ed25519）或ssh-add ~/.ssh/id_rsa（若使用RSA）。
3、若提示Could not open a connection to your authentication agent，请先运行Start-Service ssh-agent（PowerShell管理员模式）。
五、将公钥内容复制并添加至GitHub账户
GitHub通过比对客户端发送的公钥指纹与账户中登记的公钥，验证SSH连接合法性。必须确保粘贴的是纯公钥文本，不含多余空格、换行或注释行。
1、在Git Bash中执行：cat ~/.ssh/id_ed25519.pub | clip（ed25519）或cat ~/.ssh/id_rsa.pub | clip（RSA），自动复制到剪贴板。
2、登录GitHub官网，点击右上角头像 → Settings → SSH and GPG keys → New SSH key。
3、Title栏填写标识名称（如Windows-Laptop-2024），Key type保持Authentication key，将剪贴板内容粘贴至Key文本框。
4、点击Add SSH key按钮完成绑定。
六、测试SSH连接有效性
验证密钥是否被GitHub正确识别并建立可信通道，排除网络拦截、防火墙屏蔽或密钥格式错误等常见问题。
1、在Git Bash或PowerShell中执行：ssh -T git@github.com。
2、首次连接时将提示确认主机指纹，输入yes并回车。
3、若返回Hi username! You've successfully authenticated...，说明配置成功；若提示Permission denied (publickey)，请检查公钥是否完整粘贴、代理是否运行、私钥是否已添加。
