github 添加 SSH key

封面图 • 2025-11-06 • git

在 GitHub 上添加 SSH Key 是为了让你能够通过 SSH 协议与 GitHub 仓库进行安全的通信，而无需每次输入用户名和密码。以下是详细步骤：

---

## ✅ 步骤一：生成 SSH 密钥（如果还没有）

1. **打开终端**（Linux/macOS）或 **Git Bash**（Windows）。

2. **检查是否已有 SSH 密钥**：
   ```bash
   ls -al ~/.ssh
   ```
   如果看到 `id_rsa` 和 `id_rsa.pub` 文件，说明已经有密钥了。如果没有，继续下一步。

3. **生成新的 SSH 密钥**（以你的邮箱作为标识）：
   ```bash
   ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
   ```

- 按回车键确认默认路径（通常是 `~/.ssh/id_rsa`）。
   - 设置一个密码（可选，建议设置）。

---

## ✅ 步骤二：将 SSH 密钥添加到 GitHub

1. **复制公钥内容**：
   ```bash
   cat ~/.ssh/id_rsa.pub
   ```
   这会显示类似如下的内容：
   ```
   ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAr... your_email@example.com
   ```

2. **复制整行内容**（包括 `ssh-rsa` 开头的部分）。

3. **登录 GitHub**：
   打开 [https://github.com](https://github.com) 并登录。

4. **进入 SSH and GPG keys 设置页面**：
   - 点击右上角的 **Profile** → **Settings** → **SSH and GPG keys**。

5. **点击 "New SSH key" 或 "Add SSH key"**：
   - 在 **Title** 中填写这个密钥的名称（比如 "My Laptop"）。
   - 在 **Key** 中粘贴你刚才复制的公钥内容。
   - 点击 **Add SSH key**。

---

## ✅ 步骤三：测试 SSH 连接

在终端中运行以下命令测试连接：

```bash
ssh -T git@github.com
```

你应该会看到类似下面的提示：

```
Hi username! You've successfully authenticated, but GitHub does not provide shell access.
```

这表示 SSH 配置成功！

---

## ✅ 其他注意事项

- 如果你使用的是 Windows，确保 Git Bash 或 WSL 已正确安装并配置。
- 如果遇到权限问题，可以尝试修改密钥文件的权限：
  ```bash
  chmod 600 ~/.ssh/id_rsa
  chmod 644 ~/.ssh/id_rsa.pub
  ```

---

如果你需要我帮你生成 SSH 密钥或指导如何配置，请告诉我你的操作系统！