1. 为什么需要Git免密登录？
每次推送代码都要输入密码，这大概是开发者最讨厌的事情之一。我在团队协作项目中深有体会——频繁的密码输入不仅打断工作流，在自动化场景下更是直接导致脚本中断。SSH密钥认证就是解决这个痛点的标准方案。
传统HTTPS协议每次push都需要验证账号密码，而SSH协议通过非对称加密实现身份认证。简单来说，你本地生成一对密钥（公钥+私钥），把公钥上传到Git服务端。之后每次连接，服务端会用你上传的公钥来验证本地私钥的签名，整个过程无需人工干预。
提示：虽然主流平台都推荐使用SSH，但企业内网环境可能强制使用HTTPS。建议先确认所在团队的协议要求。
2. 密钥对的生成与管理
2.1 检查现有密钥
首先打开终端（Windows用户用Git Bash），执行：
ls -al ~/.ssh如果看到id_rsa和id_rsa.pub等文件，说明已有密钥。可以直接使用现有密钥，但建议为不同平台创建独立密钥。
2.2 生成新密钥
运行以下命令（替换邮箱为你的实际地址）：
ssh-keygen -t ed25519 -C "your_email@example.com"这里有几个关键点：
-t ed25519：指定密钥算法，比传统RSA更安全高效- 提示输入保存路径时，建议修改为
~/.ssh/github_ed25519这样的有意义的名称 - 密码短语（passphrase）可以为空，但建议设置并配合ssh-agent使用
生成后查看公钥内容：
cat ~/.ssh/github_ed25519.pub你会看到类似这样的输出：
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIJu3wX... your_email@example.com3. 配置Git平台公钥
3.1 GitHub配置示例
- 登录GitHub → Settings → SSH and GPG keys
- 点击"New SSH key"
- Title填写识别名称（如"办公电脑"）
- Key type保持默认的"Authentication Key"
- 将之前
cat命令输出的内容完整粘贴到Key字段
注意：公钥内容必须完整且无多余空格，建议用
pbcopy < ~/.ssh/github_ed25519.pub（Mac）或clip < ~/.ssh/github_ed25519.pub（Windows）直接复制到剪贴板。
3.2 其他平台差异
| 平台 | 配置路径 | 特殊要求 |
|---|---|---|
| GitLab | Profile → SSH Keys | 支持多密钥自动识别 |
| Bitbucket | Account settings → SSH keys | 需要单独配置仓库权限 |
| Gitee | 设置 → SSH公钥 | 中文界面但流程相同 |
4. 本地SSH配置优化
4.1 多平台密钥管理
当你有多个Git平台账户时，需要创建~/.ssh/config文件：
Host github.com HostName github.com User git IdentityFile ~/.ssh/github_ed25519 IdentitiesOnly yes Host gitlab.company.com HostName gitlab.company.com User git IdentityFile ~/.ssh/company_ed255194.2 测试连接
验证配置是否生效：
ssh -T git@github.com成功时会显示：
Hi username! You've successfully authenticated...5. 常见问题排查
5.1 权限问题
SSH对文件权限非常严格，确保：
chmod 700 ~/.ssh chmod 600 ~/.ssh/*5.2 连接超时
如果出现Connection timed out：
- 检查网络是否限制SSH端口（22）
- 尝试改用HTTPS端口：
Host github.com HostName ssh.github.com Port 443
5.3 密钥被拒绝
错误信息Permission denied (publickey)通常是因为：
- 公钥未正确上传到Git平台
- 本地使用了错误的私钥文件
- SSH agent未加载密钥（执行
ssh-add ~/.ssh/your_key）
6. 进阶配置技巧
6.1 使用ssh-agent管理密码
如果密钥设置了passphrase，可以启动ssh-agent：
eval "$(ssh-agent -s)" ssh-add ~/.ssh/github_ed25519建议将这两行加入shell的启动配置文件（如.zshrc）。
6.2 VS Code集成配置
在VS Code的settings.json中添加：
{ "git.sshCommand": "ssh -i ~/.ssh/github_ed25519" }6.3 临时切换协议
对于已经用HTTPS克隆的仓库，可以修改远程URL：
git remote set-url origin git@github.com:user/repo.git我在团队中推行这套方案时，发现90%的配置问题都源于以下三个原因：
- 公钥复制时漏掉开头/结尾字符
.ssh目录权限设置不正确- 忘记在Git平台点击"Add SSH key"按钮
有个小技巧：用ssh -vT git@github.com查看详细连接过程，输出信息能精准定位问题环节。比如看到Offering public key: /Users/you/.ssh/github_ed25519就说明密钥已被尝试使用，而Authentication succeeded则确认验证通过。