在使用Git进行版本控制时，很多开发者习惯直接用HTTPS协议克隆仓库，每次推送都需要输入账号密码，不仅麻烦还容易泄露权限。换成SSH密钥后，只需配置一次，后续所有操作都能免密完成，安全性更高，团队协作也更顺畅。下面这份教程会一步步教你如何在电脑上生成密钥，并正确绑定到GitHub或Gitee等平台上。
为什么推荐使用SSH密钥连接Git
HTTPS协议依赖用户名和密码认证，每次操作都要重复输入，且密码容易被恶意软件截获。SSH基于非对称加密技术，本地保存私钥，云端只存公钥。只要私钥不丢失，别人就算拿到你的公钥也无法冒充你操作。配置好后，克隆、拉取、推送代码全部自动完成，彻底告别手动输密码的繁琐流程，尤其适合频繁提交代码的开发环境。
第一步：检查本地是否已有SSH密钥
打开命令行工具，Windows用户用PowerShell或CMD，Mac和Linux直接打开终端。输入cd ~/.ssh命令进入SSH目录。如果提示找不到路径，说明系统还没生成过密钥，可以直接跳到下一步新建。如果能看到id_rsa、id_ed25519这类文件，说明已经存在旧密钥。建议备份后删除旧文件，避免多把钥匙冲突影响新设备登录。
第二步：在终端生成新的SSH密钥
新生成密钥前，先设置好你的邮箱，这会让生成的文件里带上你的身份标识。执行git config --global user.email你的邮箱地址命令。接着运行ssh-keygen -t ed25519 -C你的邮箱命令。系统会询问保存路径，直接回车用默认位置即可。随后会提示设置密码短语，直接回车表示不设密码，这样日常开发更快捷。完成后，终端会显示一串随机字符，并在.ssh目录下生成一对文件，带.pub后缀的就是公钥，需要公开上传；不带后缀的是私钥，绝对保密。
第三步：将公钥添加到代码托管平台
打开终端输入cat ~/.ssh/id_ed25519.pub命令，屏幕会打印出完整的公钥字符串。全选复制这段内容。登录你的代码托管网站，进入个人设置里的SSH与GPG密钥页面，点击添加新密钥。名称随便填，比如电脑型号或工作用途，把刚才复制的内容粘贴到公钥框中。注意不要漏掉开头和结尾的字母数字，点击保存即可完成绑定。如果是Gitee平台，操作路径几乎一样，只是界面文字略有不同。
第四步：测试SSH连接是否成功
回到终端，输入ssh-T git@github.com（替换为你使用的平台域名）。首次连接会提示是否信任该主机，输入yes并回车。如果看到Hi后面跟着你的用户名，并提示Authentication successful，就说明配置完全正确。此时再clone仓库，地址会自动从https变成git开头的形式，后续push和pull都不需要再验证身份。
常见问题与排错技巧
如果遇到Permission denied，先检查是否复制了公钥而不是私钥。如果是Host key verification failed，通常是因为之前连过其他IP导致指纹记录变化，可以删掉~/.ssh/known_hosts文件重新连接。某些企业网络会拦截22端口，这时候可以改用443端口代理，或者联系网管开放防火墙限制。私钥一旦丢失，只能重新生成并再次上传公钥覆盖旧记录，所以平时记得定期备份到安全位置。
掌握SSH密钥配置后，Git工作流程会流畅很多。虽然前期步骤看起来有些技术性，但按照指引操作一遍就能彻底解决认证烦恼。保持私钥安全，及时同步新设备的密钥，你的代码协作效率一定会显著提升。
