为什么需要配置公钥
Git在远程仓库交互时支持HTTPS和SSH两种协议。HTTPS每次推送都需要输入账号密码，不仅繁琐还容易暴露凭证。SSH通过非对称加密技术实现免密认证，安全性更高且操作更流畅。配置公钥就是把你本机生成的数字钥匙交给远程服务器，建立双向信任通道，之后拉取和推送代码都能一键完成。
检查本地是否已有关键文件
打开终端或命令行工具，输入cd ~/.ssh命令进入目录。如果提示没有该文件或路径不存在，说明你还没生成过密钥，可以直接跳到下一步。如果看到known_hosts、id_rsa、id_rsa.pub等文件，说明之前已经配置过。你可以用cat id_rsa.pub查看现有公钥内容，确认是否与当前使用的设备匹配。不用的旧密钥建议删除或备份，避免多设备冲突。
生成全新的SSH密钥对
在终端执行git config --global user.name 你的用户名 和 git config --global user.email 你的邮箱 设置身份信息。接着运行ssh-keygen -t rsa -b 4096 -C 你的邮箱地址。系统会提示保存路径，直接回车使用默认位置即可。随后会要求设置密钥短语，普通开发者可以直接按两次回车留空，这样使用时无需反复输入密码。生成完成后，终端会显示一串字符指纹，代表密钥创建成功。
复制公钥并绑定到代码平台
使用命令cat ~/.ssh/id_rsa.pub | clip 快速复制公钥内容，或者手动打开id_rsa.pub文件全选粘贴。登录GitHub、Gitee或GitLab等平台，进入个人设置页面的SSH Keys区域。点击添加新密钥，名称随便填，比如电脑型号，把刚才复制的一长串字符串粘贴到Key输入框。注意不要漏掉开头的ssh-rsa和结尾的邮箱标识。保存后平台通常会立即生效。
测试连接与权限验证
回到终端输入ssh -T git@github.com 或 ssh -T git@gitee.com。首次连接会询问是否继续，输入yes并回车。如果看到Hi后面跟着你的用户名以及successfully authenticated字样，说明公钥已经握手成功。此时再用git clone或git push命令，就不再需要重复验证身份。如果提示Permission denied，请检查公钥是否正确复制，或者平台账户是否绑定了正确的邮箱。
日常维护与避坑指南
多设备开发时每台电脑都要单独生成密钥并上传，不要跨机共享同一个私钥文件。遇到推送卡顿可以先用git remote -v检查远程地址是否为git开头，如果是https开头可以改为ssh格式。更换电脑或重装系统后记得重新走一遍生成流程。定期更新OpenSSH客户端能避免老旧算法被拦截。配置过程虽然只有几步，但细节决定效率，掌握这套流程能让团队协作更加顺畅。
