GitHub SSH 配置指南 🚀

波奇大帝2025-04-242025-07-01


text
# GitHub SSH 配置指南 🚀

> 本文档详细介绍了如何配置 Git 用户信息及公钥，方便安全连接 GitHub。

## 目录 📚

- [配置用户名和邮箱 ✍️](#配置用户名和邮箱-✍️)
- [配置公钥连接 GitHub 🔑](#配置公钥连接-github-🔑)
  
  展开阅读公钥生成示例和解释 💡

  - 使用 `ssh-keygen` 生成密钥对
  - 私钥 `id_rsa` 切勿外泄
  - 公钥 `id_rsa.pub` 用于配置到 GitHub SSH Keys

  
- [测试连接 ✔️](#测试连接-✔️)

---

## 配置用户名和邮箱 ✍️

在终端执行以下命令，配置 Git 的全局用户名和邮箱：

git config –global user.name “你的用户名”
git config –global user.email “你的邮箱”


text

> 💡 这里的用户名和邮箱会关联到你的每一次 Git 提交记录中。

---

## 配置公钥连接 GitHub 🔑

生成 SSH 密钥对，方便安全连接 GitHub 免输密码：

ssh-keygen -t rsa -C “你的邮箱”


text


展开查看生成密钥时的提示说明 👇

- 系统会提示：`Enter file in which to save the key`，直接**一路回车**，默认保存在 `~/.ssh/id_rsa` 和 `~/.ssh/id_rsa.pub`
- 不建议新手设置密钥密码，避免连接时频繁输入密码
- 私钥文件：`id_rsa` —— 绝对私密，切勿泄露
- 公钥文件：`id_rsa.pub` —— 复制文件内容，粘贴到 GitHub SSH 密钥设置页面



完成后，将公钥内容复制到 GitHub：

1. 登录 GitHub 账户
2. 进入 **Settings > SSH and GPG keys > New SSH key**
3. 粘贴 `id_rsa.pub` 内容，保存

---

## 测试连接 ✔️

执行下面命令测试是否成功连接 GitHub：

ssh -T [email protected]


text

正常情况下会出现类似提示：

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

---

✨ 恭喜！你已成功配置 GitHub SSH 连接，开始愉快使用 Git 吧！