github配置ssh key windows

在 Windows 上使用 HTTPS 协议操作 GitHub 仓库时，每次推送或拉取都可能需要输入账号和密码（或个人访问令牌）。配置 SSH Key 后，Git 将通过本地私钥与 GitHub 上的公钥进行匹配认证，从而实现免密操作，提升开发效率并增强安全性。本教程基于 Windows 10/11 系统，使用内置的 OpenSSH 和 PowerShell 完成全流程配置。

检查 Git 和 OpenSSH 版本确认环境就绪

1. 检查 Git 和 SSH 环境

首先确认系统中已安装 Git 且 SSH 组件可用。右键点击开始菜单，选择【Windows PowerShell】或【终端】。

输入以下命令检查版本：

git --version
ssh -V

若命令返回具体的版本号，说明环境就绪。如果提示“不是内部或外部命令”，请先安装 Git for Windows，并确保在安装过程中勾选了“Use OpenSSH”选项，或者手动将 Git 的 bin 目录添加到系统环境变量 PATH 中。

2. 生成 Windows SSH 密钥

在 PowerShell 中执行以下命令生成新的密钥对。请将 your_email@example.com 替换为你注册 GitHub 时使用的邮箱地址：

ssh-keygen -t ed25519 -C "your_email@example.com"

系统会提示选择保存路径。直接按回车键使用默认路径 C:\Users\你的用户名\.ssh\id_ed25519。接着系统会要求设置 passphrase（口令），这是保护私钥的第二道防线。如果仅在本机安全环境下使用，可以连续按两次回车留空；若建议设置强口令，则需记住该口令，后续添加密钥到 agent 时会用到。

生成成功后，.ssh 目录下会出现两个文件：id_ed25519（私钥，严禁泄露）和 id_ed25519.pub（公钥，用于上传至 GitHub）。

生成 Ed25519 密钥对并设置保存路径

3. 启动 ssh-agent 并添加私钥

为了让 Windows 在后台自动管理密钥，需要启动 ssh-agent 服务。在 PowerShell 中依次执行：

Get-Service ssh-agent | Set-Service -StartupType Manual
Start-Service ssh-agent

服务启动后，将生成的私钥添加到代理中：

ssh-add $env:USERPROFILE\.ssh\id_ed25519

如果之前设置了 passphrase，此时会提示输入。看到 “Identity added” 字样即表示添加成功。此后重启电脑，ssh-agent 也会随系统自动加载该密钥，无需重复操作。

4. 复制公钥到剪贴板

接下来需要将公钥内容复制到 GitHub。使用以下命令可直接将公钥内容写入剪贴板，避免手动复制时多出空格或换行：

Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard

也可以手动用记事本打开 id_ed25519.pub 文件，全选并复制以 ssh-ed25519 开头的那一行完整内容。

在 GitHub 设置中添加新的 SSH Key

5. 在 GitHub 账号中添加 SSH Key

登录 GitHub 网站，点击右上角头像，选择【Settings】。在左侧菜单栏找到并点击【SSH and GPG keys】，然后点击右侧的【New SSH key】按钮。

在【Title】栏输入便于识别的名称，如“Windows-PC”；在【Key】栏粘贴刚才复制的公钥内容。确认无误后点击【Add SSH key】。如果账号开启了双重验证，此时可能需要输入密码或验证码进行确认。

5. 在 GitHub 账号中添加 SSH Key

6. 测试 GitHub SSH 连接

回到 PowerShell，执行测试命令：

ssh -T git@github.com

首次连接时，系统会显示 GitHub 的主机指纹并询问是否继续。输入 yes 并回车。如果配置正确，终端会显示类似 “Hi username! You've successfully authenticated...” 的消息，表明 SSH 连接已打通。注意，这里不会提供 shell 登录权限，只要看到认证成功提示即可。

7. 把仓库远程地址改为 SSH

对于已经克隆到本地的仓库，需要将远程地址从 HTTPS 切换为 SSH。进入仓库根目录，先查看当前远程地址：

git remote -v

确认 origin 地址为 HTTPS 格式后，执行以下命令进行修改（请替换为你的实际用户名和仓库名）：

git remote set-url origin git@github.com:用户名/仓库名.git

再次执行 git remote -v 确认地址已变为 git@github.com:... 格式。随后尝试执行 git fetch 或 git push，若不再提示输入密码，则说明配置完全生效。

修改 Git 远程仓库地址为 SSH 协议

完成上述步骤后，本机与该 GitHub 账号之间的 SSH 认证通道即建立完毕。后续新增仓库时，可直接使用 SSH 地址进行克隆，无需再手动切换协议。若更换电脑或重装系统，只需重新生成密钥并在 GitHub 设置中更新公钥即可。