## 简介
在使用 GitHub 时，为了避免每次提交代码都需要输入用户名和密码，我们可以使用 SSH 密钥进行自动认证。本教程将详细介绍如何设置 SSH 密钥并配置 GitHub 自动认证。
## 步骤一：检查现有 SSH 密钥
首先，检查您的电脑是否已经存在 SSH 密钥：
```bash
ls -al ~/.ssh
```
如果看到 `id_rsa` 和 `id_rsa.pub` 文件，说明已经存在 SSH 密钥。如果没有，需要生成新的密钥。
## 步骤二：生成新的 SSH 密钥
如果还没有 SSH 密钥，使用以下命令生成：
```bash
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
```
按回车后：
1. 选择保存密钥的位置（直接回车使用默认位置）
2. 输入密码短语（可以直接回车不设置密码）
## 步骤三：启动 SSH-Agent
```bash
# 启动 ssh-agent
eval "$(ssh-agent -s)"
# 将 SSH 密钥添加到 ssh-agent
ssh-add ~/.ssh/id_rsa
```
## 步骤四：复制公钥
```bash
# Windows
clip < ~/.ssh/id_rsa.pub
# macOS
pbcopy < ~/.ssh/id_rsa.pub
# Linux
cat ~/.ssh/id_rsa.pub
```
## 步骤五：添加 SSH 密钥到 GitHub
1. 登录 GitHub 账号
2. 点击右上角头像 -> Settings
3. 点击左侧菜单 "SSH and GPG keys"
4. 点击 "New SSH key"
5. 填写标题（如：My Laptop）
6. 粘贴刚才复制的公钥内容
7. 点击 "Add SSH key" 保存
## 步骤六：测试连接
```bash
ssh -T git@github.com
```
如果看到 "Hi username! You've successfully authenticated..." 的消息，说明配置成功。
## 步骤七：更新仓库远程地址
如果之前使用 HTTPS 克隆的仓库，需要更新为 SSH 地址：
```bash
# 查看当前远程地址
git remote -v
# 更新为 SSH 地址
git remote set-url origin git@github.com:username/repository.git
```
## 注意事项
1. 请妥善保管私钥（id_rsa），不要分享给他人
2. 如果使用多台电脑，需要在每台电脑上都配置 SSH 密钥
3. 建议为 SSH 密钥设置密码，增加安全性
## 常见问题
1. 如果遇到 "Permission denied" 错误，检查：
- SSH 密钥是否正确添加到 GitHub
- SSH-Agent 是否正在运行
- 私钥权限是否正确
2. 如果遇到 "Connection refused" 错误，检查：
- 网络连接是否正常
- 是否能够访问 GitHub
- 防火墙设置是否正确
## 总结
通过以上步骤，您就可以实现 GitHub 的自动认证，无需每次提交代码时都输入密码。这种方式不仅方便，而且比使用密码更安全。