为什么推荐使用SSH密钥
在使用Git管理代码时，传统的HTTPS方式每次推送或拉取都需要输入用户名和密码，不仅操作繁琐，而且存在密码泄露的风险。SSH密钥通过非对称加密技术，在本地生成一对密钥，私钥留在你的电脑里，公钥上传到代码托管平台。配置完成后，你只需要一次性设置，之后所有Git操作都会自动完成身份验证，彻底告别重复输密码的麻烦，同时大幅提升数据传输的安全性和速度。企业级开发环境也普遍强制要求使用SSH，因为它能更好地配合自动化部署工具和CI流水线运行。
第一步：生成SSH密钥对
打开系统的终端或命令行工具。Windows用户建议直接使用PowerShell或CMD，Mac和Linux用户直接使用Terminal。执行生成命令是整个过程的核心。推荐使用更安全的Ed25519算法，命令如下：
ssh-keygen -t ed25519 -C your_email@example.com
如果系统版本较老不支持该算法，可以使用rsa算法代替：ssh-keygen -t rsa -b 4096 -C your_email@example.com。执行后，系统会提示你保存密钥的路径，直接按回车键使用默认路径即可。接下来会让你设置 passphrase，为了日常使用方便，这里可以直接按两次回车留空，这样后续操作无需再次输入密码。最后终端会显示一串字符指纹，表示生成成功。
第二步：获取并添加公钥
密钥生成成功后，你需要找到公钥文件。Windows用户通常在 C:\Users\你的用户名\.ssh\ 目录下，Mac和Linux用户在 ~/.ssh/ 目录下。找到以 .pub 结尾的文件，用记事本或任意文本编辑器打开，全选并复制里面的全部内容。以GitHub为例，登录网页版后点击右上角头像，进入Settings，选择SSH and GPG keys，点击New SSH key。将刚才复制的内容粘贴到Key输入框，Title随便填一个便于识别的名字，比如我的办公电脑，最后保存即可。其他平台如Gitee、GitLab的操作逻辑完全一致，都在账户安全设置中找到对应入口。
第三步：验证连接状态
添加完公钥后，不要急着写代码，先测试一下通道是否畅通。在终端输入测试命令，注意替换成对应的域名。例如GitHub的测试地址是：ssh -T git@github.com。执行后会提示Are you sure you want to continue connecting，输入yes确认。如果看到Hi后面跟着你的用户名，并且写着Successfully authenticated，说明配置完全正确。如果提示Permission denied，请检查公钥是否确实上传成功，或者确认本地生成的密钥是否与平台绑定的密钥匹配。有时候浏览器缓存或网络波动也会导致临时验证失败，清理缓存重试即可。
第四步：将现有仓库切换为SSH
如果你之前已经克隆过项目，使用的是HTTPS链接，现在可以一键切换协议。在项目根目录下运行查看远程地址的命令：git remote -v。你会看到origin的地址是以https开头的。接着执行修改命令：git remote set-url origin git@github.com:username/repo.git。这里的地址就是你在代码平台上看到的Clone with SSH选项里的链接。修改完成后再次运行git remote -v验证，确保地址已变为git开头。新克隆的项目直接在平台复制SSH地址即可，一步到位。切换后记得提交一次测试，确认推送正常才算真正生效。
多账号管理与常见问题排查
在实际使用中可能会遇到几个典型问题。首先是Agent未启动，报错Could not open a connection to your authentication agent。解决方法很简单，在终端运行eval ssh-agent bash即可激活。其次是多账号冲突，当你同时在多个平台使用不同密钥时，需要配置SSH配置文件。在.ssh目录下新建config文件，在里面分别指定Host别名、HostName、User以及IdentityFile路径，这样Git就能根据域名自动匹配正确的密钥。最后是权限错误，Mac和Linux用户如果发现推送到私有仓库失败，检查私钥文件的读写权限，通常执行chmod 600 id_ed25519就能恢复正常运行。定期备份私钥文件也是好习惯，防止硬盘损坏导致无法拉取代码。
掌握SSH密钥配置后，你的Git工作流会变得非常流畅。这套机制一旦建立，基本不需要再手动干预，无论是团队协作还是个人开发，都能享受到更安全高效的代码同步体验。按照上述步骤操作一遍，十分钟即可完成全套设置，后续只需专注写代码就好。
