日常开发中，每次向远程仓库推送或拉取代码都要输入用户名和密码不仅繁琐，还存在安全隐患。使用SSH密钥可以实现免密登录，既安全又高效。很多新手在配置时容易遇到命令报错或权限设置错误的问题，下面将用最直白的方式带你一步步完成Git SSH密钥的生成与配置。
检查本地是否已存在密钥
在动手生成新密钥之前，先看看电脑里是不是已经有现成的。打开终端或命令行工具，输入 cd ~/.ssh 命令进入隐藏目录。如果提示找不到路径，说明你还没生成过密钥，可以直接跳到下一步。如果能看到 id_rsa 或 id_ed25519 开头的文件，说明已经存在旧密钥。建议备份后删除旧文件，避免后续产生冲突。直接使用 rm id_* 命令清理即可，系统会默认使用新的生成方式。
执行生成命令并设置密码
接下来是核心步骤。在终端中输入 ssh-keygen -t ed25519 -C 你的邮箱地址。这里推荐使用 ed25519 算法，它比传统的 rsa 更安全且速度更快。输入命令后系统会提示你保存密钥的位置，直接按回车键使用默认路径就行。随后会要求你设置一个私钥密码，这一步可选。如果你希望每次使用都完全免密，直接连续按两次回车跳过；如果追求更高安全性，建议设置一个复杂密码，之后每次操作只需输入一次即可。
获取公钥内容
密钥生成成功后，系统会在提示中显示两条信息，其中一条是查看公钥的命令。通常路径为 cat ~/.ssh/id_ed25519.pub 或 cat ~/.ssh/id_rsa.pub。复制这条命令并运行，终端会输出一长串以 ssh-ed25519 或 ssh-rsa 开头的字符。用鼠标全选并复制这段文本，这就是你需要上传到代码托管平台的公钥。注意不要漏掉末尾的邮箱地址部分。
将公钥添加到代码平台
打开你常用的代码托管网站，比如GitHub、Gitee或GitLab，登录个人账号后进入设置页面。找到安全或SSH密钥管理选项，点击添加新密钥。标题栏随便填个名字方便自己识别，比如笔记本电脑名。把刚才复制的那整段公钥粘贴到大框里，确认无误后保存。平台会自动验证格式，验证通过后列表里就会显示你的新设备。此时你已经完成了云端配置，本地和服务器即将打通。
配置全局用户信息与测试
为了让Git正确记录你的身份，需要设置全局的用户名和邮箱。依次执行 git config --global user.name 你的名字 和 git config --global user.email 你的邮箱。这两项信息会在每次提交代码时显示在日志里，务必与你在代码平台注册的保持一致。配置完成后，输入 ssh -T git@github.com 或对应平台的测试指令。首次连接会询问是否信任该主机，输入 yes 并回车。如果看到 Hello 开头加上你的用户名字样，恭喜你配置成功。
常见问题排查技巧
如果测试时提示权限被拒绝，大概率是公钥没配对或者代理设置干扰。可以先检查 ~/.ssh 目录下的配置文件权限是否为 600，使用 chmod 600 id_* 修正。另外，有些公司网络会屏蔽特定端口，如果遇到连接超时，尝试切换网络或使用代理模式。密钥生成后尽量不要手动修改文件名，否则Git会找不到对应的私钥。保持默认命名规则是最稳妥的做法。掌握这套流程后，日常的代码同步效率会有明显提升，彻底告别反复敲密码的烦恼。