在使用Git进行代码托管时，每次推送或拉取代码都需要验证身份。传统的用户名密码方式不仅繁琐，而且随着各大平台逐步停用密码认证，SSH密钥已成为绝对主流。配置一次密钥后，后续所有操作均可免密完成，兼顾安全性与效率。本教程以通用命令行界面为基础，覆盖从生成到测试的全流程，适合各类操作系统用户参考。
检查本地是否已存在密钥
打开终端或命令行窗口，输入cd ~/.ssh命令尝试进入当前用户的SSH配置文件目录。若系统提示路径不存在，说明你从未创建过密钥，可直接跳过此步前往下一步。如果目录内有id_rsa或id_ed25519等文件，代表已存在历史密钥。为保持环境干净，建议将原有文件备份至其他文件夹后再继续操作。备份只需将整个.ssh目录复制到桌面或文档中即可，不会影响现有功能。
生成全新的SSH密钥对
在终端执行生成命令。目前官方推荐使用ed25519算法，该算法相比老式rsa更安全、计算速度更快且文件体积更小。输入ssh-keygen -t ed25519 -C your_email@example.com，记得将邮箱替换为你实际用于代码平台的注册账号。系统会提示密钥保存路径，直接按回车采用默认位置即可。随后会要求输入passphrase密码短语，连续按两次回车表示不设密码，这样日常开发不会被打断。若你重视隐私安全，可设置复杂密码，但每次联网都会触发验证。命令跑完后，终端会打印出公钥的存放路径，末尾通常带有.pub后缀。
将公钥上传至代码托管平台
SSH机制依赖公私钥配对，私钥必须严格保留在本机，严禁通过邮件或聊天软件发送。你需要提交的是公钥内容。在终端输入cat ~/.ssh/id_ed25519.pub查看文件，全选并复制输出的整行长字符串。接着登录对应的代码平台，进入个人主页的设置菜单，找到SSH Keys或部署密钥选项。新建一条记录，名称随意填写以便日后管理，将复制的内容粘贴进文本框，保存生效。此时平台已完成绑定，正式认可你的设备身份。
配置SSH代理并验证连通性
为使终端能自动调用密钥，需启动SSH守护进程。依次执行eval ssh-agent bash和ssh-add ~/.ssh/id_ed25519两条指令。若系统报错提示文件缺失，请仔细核对上一步生成的文件名是否一致。一切就绪后，输入ssh-T git@github.com或对应平台的地址进行连通测试。首次访问会询问是否加入信任列表，键入yes并回车。屏幕返回successfully authenticated字样，即表示加密通道已完全建立。
常见故障排查与维护建议
克隆仓库时仍弹出密码输入框，绝大多数情况是因为远程地址写成了https开头。请务必切换为git@开头的SSH协议链接。部分企业网络受防火墙限制，可能需要在~/.ssh/config文件中手动添加ProxyCommand参数。遇到Permission denied错误，通常是私钥权限过于开放导致系统拦截。在Linux或macOS环境下，运行chmod 600 ~/.ssh/id_ed25519即可修复。定期轮换密钥是良好的安全习惯，尤其在设备遗失或移交他人时，务必第一时间登录平台清理旧记录并重新签发。熟练运用这套机制后，版本控制协作将更加流畅稳定。