为什么推荐使用SSH代替HTTPS
在使用Git管理代码时，大多数新手默认选择HTTPS协议进行远程仓库的拉取和推送。虽然HTTPS操作简单，但每次操作都需要输入用户名和密码，不仅繁琐还容易因密码过期导致连接失败。相比之下，SSH协议通过非对称加密技术进行身份验证，配置一次后即可实现免密操作。它不仅安全性更高，能有效防止中间人攻击，而且传输效率更好，尤其适合长期参与开源项目、频繁提交代码或需要跨多台设备协作的开发者。
检查本地是否已存在SSH密钥
在开始配置之前，先看看电脑里是不是已经有现成的密钥文件。打开终端或者命令行工具，输入命令ls ~/.ssh查看当前目录。如果看到id_rsa或者id_ed25519这样的文件，说明系统已经生成过密钥。此时可以直接跳到添加密钥到平台的步骤。如果没有找到任何相关文件，就需要手动创建新的密钥对，请继续往下看。
生成全新的SSH密钥对
确保你已经安装好Git并配置了基础环境。在终端执行ssh-keygen -t ed25519 -C your_email@example.com命令，把邮箱地址替换成你注册代码平台时使用的真实邮箱。系统会提示你选择密钥保存路径，直接按回车键使用默认位置即可。接着它会要求设置passphrase，也就是密码锁，普通个人开发可以直接连续两次回车留空，这样以后推送代码不需要再次输入密码。生成完成后，终端会显示一串指纹字符，代表密钥制作成功。如果需要同时管理多个账号，可以在命令末尾指定不同的文件名，例如id_work来区分工作机和个人机。
将公钥添加到代码托管平台
密钥分为私钥和公钥，我们要上传的是公钥文件。在终端输入cat ~/.ssh/id_ed25519.pub复制全部内容。打开你的代码托管平台，进入个人账户设置里的SSH Keys页面，点击新建密钥按钮。粘贴刚才复制的内容，标题随便起个名字方便以后辨认，比如公司电脑或者家庭笔记本。提交保存后，平台就会把你的公钥加入白名单。这一步是建立信任的关键，务必确认没有多复制或少复制空格，否则会导致后续连接失败。
配置Git全局信息与测试连接
密钥准备好之后，还需要告诉Git你是谁。执行git config --global user.name 你的名字和git config --global user.email 你的邮箱分别设置署名信息。接下来验证通道是否畅通，在终端运行ssh -T git@github.com或者对应平台的域名。第一次连接会弹出是否确认主机指纹的提示，输入yes回车即可。如果返回欢迎语或者权限通过的提示，说明SSH通道已经彻底打通。建议把常用命令记在备忘录里，避免每次都要重新敲一遍参数。
把已有HTTPS仓库切换为SSH
很多老项目一开始是用HTTPS克隆的，切回SSH只需要修改远程地址。用cd命令进入项目文件夹，然后运行git remote set-url origin git@github.com:用户名/仓库名.git。替换后面的地址为你实际的仓库SSH链接，这个链接可以在网页端仓库的Clone区域一键复制。改完之后再次执行git push，如果不再弹窗要密码，就说明切换成功了。以后所有拉取和推送都会走加密通道，不用担心网络波动导致认证中断。
常见问题快速排查
如果遇到权限拒绝的情况，先核对平台后台是否真的录入了公钥，有时候复制时会漏掉末尾的换行符。如果是mac系统用户，发现每次都要输密码，可以打开钥匙串应用把ssh相关条目设为始终允许。Windows用户建议使用自带的OpenSSH或者Git Bash，避免混用第三方客户端导致环境变量冲突。定期轮换密钥也能提升账户安全性，尤其是团队人员变动的时候记得及时移除离职成员的旧公钥。掌握这些细节后，你的代码同步流程会变得非常顺畅。
