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 删掉对应的密钥，避免留下安全隐患。