为什么需要配置SSH
平时我们用Git推代码，默认走的是HTTPS协议，每次都要手动输入账号和密码，不仅麻烦还容易输错。配置SSH之后，电脑和本地仓库之间会建立加密通道，验证通过后就能免密码提交和拉取代码，安全性更高，日常开发也更顺畅。下面按步骤带你把环境配好。
第一步检查本地是否已有密钥
打开终端或者命令行工具，先看看机器里是不是已经藏着现成的SSH密钥。直接运行ls命令查看隐藏目录下的.ssh文件夹。如果看到id_rsa.pub或者id_ed25519.pub这类文件，说明之前配过，可以跳过生成步骤直接用。如果没有提示找不到路径或文件，那就继续往下走。
第二步生成新的SSH密钥对
现在最推荐的是用Ed25519算法，比传统的RSA更短更快更安全。在终端输入生成命令，记得把邮箱换成你平时注册GitHub或Gitee的那个。系统会问你要不要设置密码短语，直接回车保持空白就行，这样后面推送才不用反复敲密码。生成成功后，你会在对应目录下看到两个文件，一个带私钥后缀，一个带公钥后缀。私钥绝对保密，公钥才是给服务器认的。
第三步启动密钥代理并添加新密钥
新系统为了安全，默认不会自动加载私钥到内存。我们需要手动启动ssh-agent服务，然后把刚才生成的私钥加进去。依次执行启动代理的命令和添加密钥的命令，遇到提示直接回车确认。这一步做完，系统后台就已经记住你的密钥了，后续操作才会顺利。
第四步复制公钥粘贴到代码平台
用文本编辑器打开那个带pub后缀的文件，或者直接运行cat命令把内容显示出来。全选复制整段以ssh开头以邮箱结尾的字符串。接着登录你的代码托管平台，进入个人设置里的SSH密钥管理页面，点击新建密钥，随便起个名字方便识别，把刚才复制的内容粘贴到大框里，保存即可。国内常用的Gitee和Gitea操作界面也差不多，找对位置填上就行。
第五步测试连接是否正常
配置完别急着写代码，先用测试命令验证一下链路通不通。执行测试指令，首次连接会问你确不认识该主机，输入yes回车。如果最后显示认证成功或者欢迎语，就说明彻底跑通了。这时候再去克隆远程仓库或者推送代码，全程都不会再弹窗要密码。
常见问题排查思路
万一测试还是报错权限被拒绝，多半是权限没改对。Linux和Mac系统下，私钥文件的权限必须是六十，可以用chmod命令修正。Windows用户如果发现连不上，检查一下Git Bash有没有正确读取用户目录下的隐藏配置文件夹。还有时候平台提示密钥已存在但就是不能用，去列表里删掉旧的那条重新添加一次。网络环境差的时候偶尔也会超时，换个DNS或者切换手机热点试试。
日常维护注意事项
密钥配好后就不用管了，但要注意保管好那台电脑的磁盘分区。重装系统或者换硬盘前，记得把私钥文件备份到U盘或者云盘，否则重新生成后还得去所有平台解绑旧密钥再绑定新密钥，非常耽误时间。多人协作时，每人用自己的密钥，不要共享同一个账号推送，出了问题方便追溯是谁提交的代码。定期清理不用的旧电脑上的遗留密钥，也能减少安全隐患。
