Windows配置Git SSH密钥教程

本文详细讲解了在Windows系统上配置Git SSH密钥以安全连接GitHub的完整流程，涵盖密钥存在性检查、使用PowerShell或Git Bash生成ed25519/RSA密钥对、启动SSH代理并加载私钥、将公钥准确添加至GitHub账户，以及最终通过ssh -T命令验证连接是否成功；无论你是首次配置还是遇到“Permission denied (publickey)”等常见报错，这套清晰、分步、兼顾兼容性与安全性的实操指南都能帮你快速打通本地开发环境与GitHub之间的SSH信任通道。

如果您尝试通过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）。

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)，请检查公钥是否完整粘贴、代理是否运行、私钥是否已添加。

今天关于《Windows配置Git SSH密钥教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！