为什么需要配置SSH
平时我们克隆或推送代码时，通常使用HTTPS链接，每次操作都要手动输入账号和密码，不仅繁琐而且容易输错。配置SSH之后，本地电脑和远程仓库之间会建立一条加密通道，以后拉取和提交代码直接通过终端命令完成，全程不需要再次输入密码，安全性和效率都会大幅提升。这也是所有专业开发者必须掌握的标准化操作。
检查本地是否已有SSH密钥
在动手之前，先看看你的电脑里是不是已经生成了密钥对。打开系统的命令行工具，Windows用户推荐使用Git Bash或者PowerShell，Mac和Linux用户直接使用终端。输入命令 ls ~/.ssh 并回车。如果提示没有这个文件或目录，说明你是第一次配置，可以直接跳到生成步骤。如果里面已经看到了 id_rsa 和 id_rsa.pub 这样的文件，说明系统里已经有旧密钥了。为了避免后续出现密钥冲突，建议备份旧文件或者直接删除它们，重新开始配置最稳妥。
生成新的SSH密钥对
这一步是整个流程的核心。在命令行中输入生成命令，邮箱地址换成你自己常用的那个即可：ssh-keygen -t ed25519 -C "你的邮箱@example.com"。执行后系统会提示你按几次回车键确认。Ed25519是目前官方推荐的安全算法，运算速度更快且抗破解能力更强。如果使用的是较老版本的Git客户端，也可以改用传统算法，把命令里的 ed25519 换成 rsa 即可。一路保持默认设置下来，密钥就会自动保存在电脑的隐藏目录里。生成成功后，务必去该目录下找到以 pub 结尾的文件，这就是公钥，后续的绑定环节全靠它。
将公钥添加到代码托管平台
拿到公钥内容后，下一步是把它交给Git平台进行身份认证。用文本编辑器或者终端命令把公钥内容完整复制出来。登录对应的平台网站，进入个人设置页面里的 SSH Keys 选项。粘贴刚才复制的内容，起一个方便团队识别的名字，比如办公电脑或主力机型，然后点击添加或保存按钮。此时平台数据库就已经记录了你设备的指纹信息。
测试连接是否成功
配置完公钥别急着开始写代码，先做个连通性测试。在终端输入 ssh -T git@github.com 。如果是Gitee就改成 git@gitee.com 。首次连接时会弹出询问是否信任该主机，直接输入 yes 回车即可。屏幕如果出现 Welcome to your username 之类的欢迎语，就说明安全通道已经彻底打通了。如果一直卡住或者返回 Permission denied ，通常是公钥内容复制不完整，或者是系统防火墙拦截了连接请求。
设置全局用户名和邮箱
SSH连上只是基础步骤，Git运行还需要知道提交者是谁。如果不设置，执行 push 指令时会直接报错中断。继续在终端执行两条配置命令，把引号里的内容换成你在平台上注册的真实姓名和邮箱：git config --global user.name "你的名字" 和 git config --global user.email "你的邮箱@example.com"。这两条命令会把身份信息写入系统级配置文件，以后在该电脑上创建的任何仓库都会自动继承这些参数。想核对当前状态，输入 git config --list 即可查看。
日常使用与常见问题排查
全部配置完成后，克隆项目可以直接替换协议头。把原来网址开头的 https:// 改为 git@，后面紧跟仓库路径即可。如果遇到权限拒绝的报错，绝大多数情况是本地私钥和平台绑定的公钥不一致，或者文件权限被意外修改。Mac和Linux用户可以通过 chmod 600 ~/.ssh/id_ed25519 快速修正私钥权限。Windows用户特别注意不要用带BOM编码的记事本直接修改密钥文件，这会破坏二进制结构导致验证失败。另外，如果电脑同时管理多个项目，建议在 .ssh 目录下新建 config 文件来区分不同平台的密钥路径，避免混淆。掌握这套流程后，日常开发中的代码同步会变得极其顺畅，配合终端快捷键使用，工作流将更加专注高效。
