AI模型：Deepseek

仅供参考。

第一步：生成 SSH 密钥对

在终端（Windows 推荐用 Git Bash 或 PowerShell）中运行：

ssh-keygen -t ed25519 -C "your_email@example.com"

将 your_email@example.com 替换为你的 GitHub 注册邮箱。

然后按提示操作：
- 保存路径：直接回车，使用默认路径 ~/.ssh/id_ed25519
- 密码短语：可选但推荐设置，为私钥多加一层保护
- 若 ed25519 算法不可用（如系统过旧），可改用 RSA：ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

密钥文件说明：
~/.ssh/id_ed25519 是私钥，留在本地，绝对不要分享给任何人。
~/.ssh/id_ed25519.pub 是公钥，需要添加到 GitHub。

第二步：添加到 ssh-agent（可选）

启动 SSH 代理并将私钥添加进去：

eval "$(ssh-agent -s)" # 启动 ssh-agent
ssh-add ~/.ssh/id_ed25519 # 添加私钥

这样可以在当前会话中重用密钥，避免重复输入密码。

第三步：将公钥添加到 GitHub

1. 复制公钥
- macOS：pbcopy < ~/.ssh/id_ed25519.pub
- Linux（需装 xclip）：xclip -selection clipboard < ~/.ssh/id_ed25519.pub
- Windows Git Bash：cat ~/.ssh/id_ed25519.pub | clip
- 通用方法：cat ~/.ssh/id_ed25519.pub，然后手动选中并复制所有输出

2. 登录 GitHub 添加
1) 登录 GitHub，点击右上角头像 → Settings
2) 左侧边栏点击 SSH and GPG keys
3) 点击 New SSH key 按钮
4) 填写信息：
- Title：填写一个便于识别的名称（如 "My MacBook Pro" 或 "Office Desktop"）
- Key type：保持默认的 "Authentication Key"
- Key：粘贴刚刚复制的公钥内容
5) 点击 Add SSH key，按要求确认密码

第四步：测试连接

在终端中运行：

ssh -T git@github.com

首次连接会提示确认 host key，输入 yes 继续。看到如下输出即表示成功：

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

如果看到权限拒绝（Permission denied）错误，请检查公钥是否完整粘贴、邮箱是否正确。

第五步：使用 SSH 协议操作仓库

配置完成后，即可使用 git@github.com: 格式的地址：

- 克隆新仓库：
git clone git@github.com:用户名/仓库名.git
示例：git clone git@github.com:octocat/Hello-World.git
SSH 地址可从仓库页面点击 "Code" → "SSH" 获取

- 修改既有仓库（将 HTTPS 地址改为 SSH）：
git remote set-url origin git@github.com:用户名/仓库名.git

之后 git push、git pull 就不再需要每次输入密码了。

常见问题排查

- ssh-add 报 "Could not open a connection"：先执行 eval "$(ssh-agent -s)" 启动代理
- 公司网络封锁 22 端口：改用 443 端口：ssh -T -p 443 git@ssh.github.com
- Windows 环境没有 ssh-keygen：安装 Git for Windows，使用 Git Bash

小建议：一台设备配一个密钥就够了，如果换新电脑重新走一遍流程即可。不再用的旧设备记得去 GitHub 删掉对应的密钥，避免留下安全隐患。