在Linux系统中使用Git管理代码时，配置SSH密钥是最高效且安全的连接方式。相比每次推送都需要输入账号密码的HTTPS模式，SSH密钥一旦配好，就能实现免密拉取和提交，大幅提升开发效率。很多新手在配置过程中容易卡在权限或路径问题上，下面这份教程会用最直白的语言，带你一步步完成从生成到测试的全流程，确保一次配置成功。
检查是否已存在旧密钥
打开终端后，先别急着生成新密钥。系统可能已经帮你建好了。执行ls命令查看家目录下的隐藏文件夹列表。如果看到id_rsa.pub或者id_ed25519.pub这样的文件，说明密钥已经存在。你可以直接跳到添加公钥的步骤，或者为了安全起见选择覆盖生成新的。建议备份旧文件后再操作，避免误删导致其他仓库无法访问。老项目的配置文件里通常也记录了旧的密钥路径，迁移时要注意同步更新。
生成全新的SSH密钥对
确认没有可用密钥后，使用ssh-keygen命令创建新对。推荐直接使用默认的RSA算法配合较长的密钥长度，兼容性最好。执行命令后系统会提示你保存位置，直接按回车键使用默认路径即可。接着会让你设置密钥保护密码。如果你是在个人电脑上操作，直接两次回车留空会更省事；如果是团队共享服务器，强烈建议设置一个强密码来增加安全性。完成后，终端会显示指纹信息，表示生成成功。整个过程不需要额外安装任何依赖包。
将公钥添加到代码托管平台
密钥生成后，你需要把公钥内容复制并绑定到你的代码托管平台账号上。用cat命令读取公钥文件内容，全选复制。登录你的平台，进入用户设置里的SSH Keys页面。点击新建或添加，粘贴刚才复制的内容。标题栏可以随便填，比如写上当前服务器的名称，方便以后管理多个设备。保存后，平台会自动校验公钥有效性。注意不要漏掉末尾的换行符，有些平台对格式要求比较严格，粘贴前最好用文本编辑器检查一下。
配置Git全局身份与远程地址
密钥绑好后，还需要告诉Git你是谁。执行两行全局配置命令，分别填写你在托管平台上注册的真实邮箱和昵称。这一步是为了让每次提交的记录都能正确显示作者信息。配置完身份后，如果之前是用HTTPS克隆的仓库，需要把远程地址切换成SSH格式。可以通过git remote set-url origin命令修改，或者直接重新用git clone加ssh链接克隆一遍，确保后续操作走的是加密通道。替换完成后，用git remote -v核对一下当前指向的协议是否正确。
启动SSH代理并测试连通性
为了让系统自动识别并使用新密钥，需要把私钥加入SSH代理进程。运行eval命令启动代理，再用ssh-add把生成的私钥路径加载进去。最后一步是验证配置是否成功。执行一条针对目标平台的连通测试命令，看到提示Hi开头加你的用户名和successfully authenticated的字样，就说明整条链路已经完全打通。此时再尝试push或pull，就不会再弹窗要求输密码了。测试失败的话，通常是因为代理没加载密钥，重新执行一遍加载命令即可解决。
常见问题与注意事项
如果遇到权限拒绝报错，十有八九是文件权限不对。Linux对私钥的保护非常严格，必须确保私钥文件的权限设置为只有所有者可读写。可以用chmod命令快速修正。另外，如果电脑重装或换了终端工具，记得重新把公钥上传到新机器，否则之前的绑定会失效。定期更换密钥也是好习惯，特别是离职交接或发现设备可能泄露时，及时在平台删除旧公钥能彻底切断风险。掌握这套流程后，日常协同开发会变得异常流畅。