Git SSH Key 配置
懂哥专享
前置：安装 Git，注册 GitHub 或 Gitee 账号
# 0. 配置用户信息
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱@example.com"
# 1. 生成 SSH Key
ssh-keygen -t rsa -b 4096 -C "你的邮箱@example.com" # 一路回车
# 2. 查看并复制公钥
cat ~/.ssh/id_rsa.pub # 复制输出的全部内容
# 3. 添加到 GitHub/Gitee
# GitHub: https://github.com/settings/keys -> New SSH key
# Gitee: https://gitee.com/profile/sshkeys -> 添加公钥
# 4. 测试连接
ssh -T git@github.com # 或 git@gitee.com
# 5. 仓库操作
git clone git@github.com:用户名/仓库名.git # 克隆仓库
# 或修改已有仓库的远程地址
git remote set-url origin git@github.com:用户名/仓库名.git
概述
记录如何配置 Git SSH Key，配置后可以免密码操作 Git 仓库。
环境准备
需要：
- Git（下载地址）
- 代码托管平台账号（GitHub/Gitee）
配置用户信息
在使用 Git 之前，需要先配置用户名和邮箱：
# 配置全局用户名
git config --global user.name "你的用户名"
# 配置全局邮箱
git config --global user.email "你的邮箱@example.com"
# 查看配置
git config --list
这些信息会被用于记录代码提交者的身份。建议使用与代码托管平台相同的用户名和邮箱。
创建 SSH Key
-
打开终端
- Windows：Git Bash
- macOS/Linux：终端
-
执行以下命令，之后会提示输入一些配置信息，全部回车即可，直到看到类似下面这样的随机图案表示生成成功：
ssh-keygen -t rsa -b 4096 -C "你的邮箱@example.com"
+---[RSA 4096]----+
| .o+*+oo. |
| . =+*o. |
| + +.*o |
| . B.+ . |
| = o.S |
| + + o . |
| . + = . |
| . * o |
| . o.E |
+----[SHA256]-----+
具体图案可能不同，只要看到类似这样的 ASCII 艺术图案就说明生成成功了。
添加公钥到代码平台
- 复制公钥：
# 查看公钥内容
cat ~/.ssh/id_rsa.pub
会显示类似下面这样的内容（以 ssh-rsa 开头，以你的邮箱结尾）：
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDFt7TvXnp5GYzE9zqzBm3Gu8Vx9ZWXKrKSYJ1KT4RKJ9ZvwXn5PZKz6oNBzwkJ4bqyHvKcZEDJNbwNHoc0NJ7Zf0YyPqNZh9Bj+0j6... 你的邮箱@example.com
- 添加公钥：
GitHub：
- GitHub Settings
- New SSH key
- 标题（如：MacBook）
- 粘贴公钥
- Add SSH key
Gitee：
- Gitee 设置
- 添加公钥
- 填标题
- 粘贴公钥
- 添加
测试连接
# GitHub
ssh -T git@github.com
# Gitee
ssh -T git@gitee.com
成功提示：Hi xxx! You've successfully authenticated
仓库操作
# 克隆仓库
git clone git@github.com:用户名/仓库名.git
# 修改已有仓库的远程地址
git remote set-url origin git@github.com:用户名/仓库名.git
常见问题
公钥认证失败
- 检查公钥是否已添加到平台
- 确认使用 SSH 地址（
git@开头）而非 HTTPS 地址
安全注意
- 私钥（
id_rsa）需保密 - 设备丢失要删除对应公钥
- 建议定期更换
参考
- GitHub SSH 文档
- Gitee SSH 文档
