在软件开发与团队协作中，HTTPS方式拉取代码每次都需要输入账号密码，不仅效率低，还容易在日志或终端中留下凭证痕迹。SSH协议基于非对称加密技术建立安全通道，支持免密认证，既能防止中间人攻击，又能无缝对接CI/CD自动化流程。掌握Git SSH的配置方法，是提升版本管理效率的必修课。下面为你梳理一套从零开始搭建的完整流程，步骤经过实际验证，直接照着操作即可顺利跑通。
第一步：检查本地是否已存在密钥
打开系统的终端或命令行工具，输入命令查看当前系统是否已经生成过SSH密钥对。执行 ls ~/.ssh 后，如果看到 id_rsa、id_ed25519 或 known_hosts 等文件，说明你之前已经配置过相关环境，可以直接跳过生成环节，进入添加公钥的步骤。如果提示没有那个文件或目录，则说明需要从头创建新的密钥对。
第二步：生成SSH密钥对
目前主流推荐使用ed25519算法，它在保证极高安全性的同时，生成速度比传统的rsa算法快得多。在终端中输入 ssh-keygen -t ed25519 -C your_email@example.com ，记得将邮箱替换为你实际使用的注册邮箱。系统会依次询问存储路径和密码短语。直接按回车键采用默认路径即可。密码短语强烈建议设置一个复杂但易记的组合，开启后每次调用密钥都会进行二次验证，有效防止私钥泄露风险。生成结束后，终端会打印出密钥指纹，此时私钥与公钥已分别保存在本地文件夹中。
第三步：启动代理并将密钥加入
出于安全策略考虑，现代操作系统默认不会在登录时自动加载私钥。需要手动启动SSH代理进程来托管密钥。在Mac和Linux环境中，运行 eval "$(ssh-agent -s)" 即可激活后台服务。Windows用户如果使用Git Bash，通常会自动处理该步骤，若遇到报错可手动执行 start-ssh-agent 。紧接着输入 ssh-add ~/.ssh/id_ed25519 ，按需输入刚才设置的密码短语，系统将私钥载入内存缓存，后续的所有Git推送请求都将自动完成身份核验。
第四步：获取公钥并绑定到代码平台
进入.ssh目录，使用 cat ~/.ssh/id_ed25519.pub 查看完整的公钥文本。整行内容以ssh-ed25519开头，以你的邮箱结尾，这是唯一需要对外公开的字符串。打开GitHub、Gitee或GitLab的个人中心，导航至Settings中的SSH Keys板块，点击New Key或Add Key按钮。标题栏可以自定义设备名称方便日后管理，将刚才复制的长文本粘贴到Key输入框内，最后点击Save或Add。这一步相当于把你的电脑硬件指纹录入到服务器的访问白名单中。
第五步：验证连接并切换仓库协议
公钥添加完毕后，务必进行一次连通性测试。在终端输入 ssh -T git@github.com ，若是Gitee平台则替换为 git@gitee.com ，GitLab对应 git@gitlab.com 。首次连接时会提示确认主机指纹，输入 yes 回车继续。当终端返回 Hi 你的用户名! You have successfully authenticated, but does not provide shell access. 字样时，证明加密通道已成功打通。如果历史项目原本使用的是HTTPS地址，可以通过 git remote set-url origin git@github.com:用户名/项目名.git 命令一键改写远程地址。此后执行 git pull 或 git push 都会走SSH通道，彻底告别密码弹窗。
第六步：日常使用与故障排查
配置完成后，日常开发只需按照常规流程执行代码提交与同步即可。遇到Permission denied错误时，优先核对公钥是否完整复制且未混入换行符或空格，其次确认代码平台的账户权限是否正确开放。若终端提示Host key verification failed，通常是更换了办公电脑或重装系统导致本地信任列表冲突，运行 ssh-keygen -R github.com 清理旧记录后重新发起连接即可恢复。熟练运用这套机制后，你将获得稳定高效的代码同步体验，为大型项目开发打下坚实基础。
