在使用Git进行代码管理时，传统的方式需要每次拉取或推送都输入账号和密码，不仅操作繁琐，而且明文传输存在一定的安全隐患。配置SSH密钥后，只需在本地生成一对加密文件，并将公钥绑定到代码托管平台，后续所有交互均可自动完成身份验证，实现真正的免密操作。无论是GitHub、Gitee还是GitLab，这套流程都是相通的。下面将详细说明从生成到测试的全过程。
检查本地是否已有密钥
打开系统的终端或命令行窗口，输入命令 ls -al ~/.ssh 查看是否存在现有的密钥文件夹。如果列表中出现 id_rsa 或 id_ed25519 开头的文件，说明已经配置过密钥。此时可以选择继续使用旧密钥，也可以为了安全考虑删除旧文件并重新生成。若提示没有该文件或目录，则说明是全新环境，直接进入下一步。
生成新的SSH密钥对
现代开发环境中强烈推荐使用ed25519算法，它在安全性、生成速度和存储空间上都优于传统的rsa算法。在终端执行 ssh-keygen -t ed25519 -C "你的常用邮箱" 命令。系统会询问保存路径，直接按回车采用默认位置即可。随后会提示设置密码短语，这一步完全由你自己决定。设置复杂密码可以防止私钥被盗用时的二次风险，但每次首次连接可能需要输入；留空则实现全自动免密，适合单人日常项目。完成后终端会显示密钥指纹及存放路径。
将公钥添加到代码平台
密钥生成后，我们需要提取公钥部分。执行 cat ~/.ssh/id_ed25519.pub 命令，终端会打印出一串以 ssh-ed25519 开头的长文本。全选并复制全部内容。以GitHub为例，登录后点击右上角头像进入Settings，左侧菜单找到SSH and GPG keys，点击New SSH key按钮，将内容粘贴到Key输入框，Title栏填写设备名称便于后期管理，最后点击Add SSH key保存。国内平台如Gitee的操作路径为个人中心设置内的SSH公钥，流程完全一致。
配置Git全局信息与连接测试
密钥就绪后，建议先统一配置全局提交者信息，避免每次新建仓库都要重复设置。依次运行 git config --global user.name "你的名字" 和 git config --global user.email "你的邮箱"。接下来验证通道是否畅通，以GitHub为例输入 ssh -T git@github.com 。首次连接会提示是否继续，输入 yes 并回车。验证通过后屏幕会显示 Hi 加你的用户名，代表密钥认证成功。若提示 Permission denied ，请检查公钥是否正确上传以及远程地址是否匹配。
地址转换与多账号管理技巧
很多开发者遇到免密失效，根本原因是仓库仍在使用HTTPS协议。可以通过 git remote -v 查看当前远程地址，若以 https:// 开头，请使用 git remote set-url origin git@github.com:用户名/仓库名.git 将其改为SSH格式。对于同时维护多个平台账号的情况，可以在 ~/.ssh/config 文件中定义不同Host别名，指定各自的IdentityFile路径，从而避免密钥冲突。此外，务必保证私钥文件权限严格限制为仅所有者可读，Linux和macOS可执行 chmod 600 ~/.ssh/id_ed25519 修复权限拦截。养成定期备份私钥的习惯，一旦遗失需及时在平台删除旧公钥并重新生成替换。
SSH密钥的配置看似步骤较多，实则一劳永逸。掌握这套机制后，不仅能享受极速的代码同步体验，还能从根本上提升版本管理的安全性。按照本文指引操作，几分钟内即可打通本地与云端的安全通道，让日常开发回归专注本身。
