很多开发者在初次使用Git管理代码时，习惯用HTTPS方式拉取仓库。虽然一开始能正常下载，但每次推送代码都要输入用户名和密码，不仅繁琐，还容易遇到密码过期或权限验证失败的问题。切换到SSH协议是彻底解决这些麻烦的最佳方案。SSH配置的核心在于生成一对公私钥，把公钥交给代码托管平台，之后本地与服务器通信就会自动完成身份核验，实现真正的免密操作。下面带你一步步搞定整套流程，过程中会标注截图位置，照着做就能顺利通关。
第一步检查电脑是否已有SSH密钥
打开终端或命令行工具，Windows用户可以用CMD或者PowerShell，Mac和Linux直接打开Terminal。先输入cd ~/.ssh命令进入目录。如果提示没有这个文件夹，说明你还没生成过密钥，可以直接跳到下一步去新建。如果能看到id_rsa、id_ed25519这类文件，代表已经存在旧密钥。建议先备份再重新生成，避免覆盖重要项目凭证。备份方法很简单，把整个.ssh文件夹复制到桌面即可。这一步是为了防止误删影响其他工具的正常使用，尤其是公司统一发放的开发机，乱动旧配置可能导致内部系统登不上。
第二步生成全新的SSH密钥对
在命令行里输入以下命令并回车：ssh-keygen -t ed25519 -C your_email@example.com。这里替换成你的注册邮箱，方便以后识别是哪台机器生成的钥匙。系统会提示你保存路径，直接按回车走默认位置就行。接着会让设置密码短语，一般开发环境直接连续按两次回车留空即可，这样就不用每次输密码了。执行完毕后，终端会显示一串随机图案和确认信息，说明生成成功。接下来找到公钥文件，通常叫id_ed25519.pub。双击用记事本打开，全选复制里面的内容。注意别漏掉开头的ssh-ed25519和结尾的邮箱地址，这是平台认人的关键标识。
第三步把公钥添加到代码托管平台
登录你的Git服务后台，以GitHub和Gitee为例，路径略有不同但逻辑一致。进入个人设置页面，找到安全或SSH密钥管理栏目。点击添加新密钥按钮，随便起个名字比如WorkLaptop，然后把刚才复制的长串字符粘贴到公钥框里。提交前最好核对一下有没有多余空格。平台保存后，通常会立刻生效。如果是企业内网部署的GitLab，则找管理员开通权限或在个人偏好设置里自助录入。这一步相当于把家里的钥匙复印件交还给门卫，后续进门就不需要再次登记身份了。部分平台可能需要几分钟缓存刷新，稍等片刻再去测试。
第四步测试连接是否畅通
公钥录入完成后别急着克隆项目，先跑一次连通性检测。在终端输入ssh -T git@github.com（换成对应平台的域名）。首次连接会弹出一段警告提示指纹未知，输入yes确认继续。几秒后如果看到Hi开头后面跟着你的用户名，并且提示Authentication successful，就说明配置完全正确。如果出现Permission denied，请回头检查公钥是否粘贴完整，或者网络代理是否干扰了端口转发。测试通过后再进行下一步仓库迁移，确保底层链路已经打通。
第五步将现有仓库切换为SSH地址
对于已经克隆下来的项目，不需要重新下载。只需修改远程仓库的地址记录。在项目根目录打开终端，输入git remote set-url origin git@github.com:username/repo.git。把冒号后面的路径替换成你自己的仓库SSH链接。可以在平台主页点击Clone按钮，选择SSH标签页直接复制。改完后执行git push测试，如果不再弹窗索要密码，而是直接显示传输进度，就代表切换成功。以后所有pull、fetch、push操作都会走加密通道，速度和安全性都大幅提升。遇到多项目多账号混用的情况，建议在.ssh目录下新建config文件，按域名分别指定identityfile，管理起来会更加清晰省心。
