为什么推荐切换到SSH
很多开发者习惯用HTTPS协议拉取代码，但每次推送都需要输入账号密码，体验并不流畅。切换到SSH协议后，只需一次性配置密钥，后续操作全程免密，不仅更安全，而且传输效率更高。下面按照实际开发场景，把切换步骤拆解清楚，帮助新手快速上手。
生成SSH密钥对
打开终端或命令行工具，直接运行命令生成新密钥。建议统一使用ed25519算法，安全性高且文件体积更小。输入命令后系统会提示保存路径，直接回车使用默认位置即可。如果提示已存在旧密钥，可以备份后重新生成。整个过程不设置密码也能直接使用，但加上密码能多一层保护，根据个人习惯决定。生成完成后，终端会显示指纹信息，公钥文件通常位于用户目录下的隐藏文件夹中，文件名以pub结尾。记得不要随意更改私钥文件的权限，Linux和macOS系统要求私钥必须保持严格的读写控制，否则会被安全策略拦截。
配置平台公钥
找到刚生成的公钥文件，用文本编辑器完整打开并复制全部内容。不同平台的添加入口略有差异。GitHub在个人设置的SSH Keys页面粘贴；Gitee在安全设置里找到SSH公钥选项；GitLab则在用户偏好设置中管理密钥。粘贴时不要漏掉开头结尾的标识符，确保内容一字不差。提交保存后，平台会自动校验格式。部分企业内网可能需要联系管理员审批，耐心等待状态变为已启用。添加完成后，建议给密钥起个备注名，方便日后识别是哪台电脑生成的凭证。
测试与切换仓库协议
公钥添加成功后，先跑一条测试命令确认连通性。终端返回欢迎语并显示对应用户名，说明密钥配对正确。接下来修改现有仓库的远程地址。进入项目根目录，查看当前remote配置，将原本的https链接替换为ssh格式的短链。替换后可以执行一次fetch验证是否恢复正常。修改远程地址时，可以直接输入命令覆盖原有URL。替换完成后建议执行一次空推测试，确认权限无误后再进行日常开发。新建仓库时直接在创建页选择SSH地址栏复制即可，避免手动拼接出错。
常见问题处理
如果遇到权限拒绝提示，首先核对公钥是否真正上传到正确的账户。多个账户共存时，需要在配置文件里指定不同主机的密钥路径，否则默认加载第一个会导致鉴权失败。系统提示未知主机警告属于正常现象，首次连接自动写入信任列表，再次访问就不会再弹框。Windows用户若遇到权限报错，检查私钥文件读写属性，必要时以管理员身份重启终端服务。密钥丢失无法恢复，务必定期备份到保险柜或密码管理器。日常维护中，定期检查密钥有效期和平台审计日志，能有效防范未授权访问风险。部分公司内网防火墙会拦截特定端口，此时需要联系运维开放默认通道。证书颁发机构异常时，可尝试更新系统根证书库。遇到网络波动导致的连接超时，可以尝试关闭压缩功能或更换DNS解析，大多数情况下能顺利恢复通信。
