在使用Git进行代码管理时，每次推送或拉取都需要输入账号密码非常麻烦。配置SSH密钥可以实现免密操作，不仅提升日常开发的效率，还能通过加密传输增强代码库的安全性。下面将一步步带你完成密钥的生成、添加与测试，全程无需复杂命令，按提示操作即可顺利打通本地与远程仓库的连接。
第一步检查是否已有密钥
打开终端或命令行工具，输入cd ~/.ssh查看是否存在密钥文件。如果提示目录不存在，说明你还没生成过密钥，直接跳到下一步。如果看到id_rsa或id_ed25519这类文件，说明已经存在旧密钥。为了避免冲突，建议重命名或删除旧文件，输入mv id_rsa id_rsa.bak即可备份。这一步能防止新密钥覆盖原有配置，影响其他项目的正常使用。
第二步生成新的密钥对
在命令行中输入ssh-keygen -t ed25519 -C your_email@example.com。这里把your_email@example.com换成你的常用邮箱，方便后续追踪。系统会询问保存路径，直接回车使用默认位置即可。接着会提示设置密钥密码，如果不希望每次使用都输入密码，连续两次回车跳过即可。完成后会在.ssh目录下生成两个文件，一个是私钥，绝对不要泄露给任何人；另一个是公钥，后面需要用到。
第三步获取并复制公钥
公钥文件通常以.pub结尾。在终端输入cat ~/.ssh/id_ed25519.pub可以直接显示内容。全选并复制这一长串字符，或者用cp ~/.ssh/id_ed25519.pub | clip命令在Windows上直接复制到剪贴板。注意不要漏掉末尾的邮箱地址，也不要多出空格或换行。如果不确定是否复制完整，可以在记事本里粘贴核对一下格式是否连贯。
第四步绑定到代码平台
登录你要使用的Git托管平台，比如GitHub、Gitee或GitLab。进入个人设置里的SSH Keys页面，点击新建或添加按钮。标题随便填，比如电脑名称或工作备注，方便以后识别和管理。把刚才复制的公钥粘贴到内容框里，点击保存。部分平台可能需要你输入账户密码进行二次验证，按提示完成即可。绑定成功后，平台会自动检测密钥是否匹配。
第五步配置本地Git信息
密钥绑定好后，还需要告诉Git你的身份信息。在终端依次执行git config --global user.name你的名字和git config --global user.email你的邮箱。这两行命令会把提交记录的作者信息固定下来，避免每次都要手动填写。如果发现写错了，直接覆盖执行一遍即可修改。全局配置只会影响当前用户的所有仓库，不会影响系统其他设置。
第六步测试连接是否成功
所有步骤完成后，运行ssh-T git@github.com（如果是Gitee就改成git@gitee.com）。第一次连接会提示确认主机指纹，输入yes回车即可。看到Hi开头的一行文字并附带你的用户名，就说明配置完全成功。之后clone仓库或push代码时，就不再需要反复输入密码了。测试失败的话，请重新检查公钥是否正确粘贴，以及网络连接是否正常。
常见问题处理
如果遇到Permission denied错误，先检查公钥是否完整粘贴，有没有隐藏的特殊字符。有时终端缓存会导致认证失败，可以输入eval ssh-agent bash重新启动代理。如果换了多台电脑，记得在每台设备上都重复上述步骤。私钥文件权限也很重要，Linux和macOS下建议用chmod 600设置严格权限，防止被系统拦截。掌握这些细节后，日常开发中的版本同步会变得非常顺畅。
多账号或多设备的管理技巧
如果你同时使用多个Git账号，或者需要在公司电脑和家庭电脑之间切换，可以借助配置文件区分不同环境。在项目根目录下创建config文件，针对不同的主机名指定不同的私钥路径。这样Git会自动匹配对应的密钥，避免身份混淆。定期清理不用的密钥也能保持系统整洁，降低安全风险。遇到问题时，善用git remote -v查看当前仓库的地址类型，确保使用的是ssh开头的链接而不是https。
