在使用 GitHub 进行代码托管时最常遇到的痛点包括：SSH 连接失败、权限被拒绝、找不到私钥文件等。下面按步骤详细阐述如何使用 SSH 连接 GitHub，并针对这些常见问题给出方法。

至于准备工作。所需工具

• Git
• 终端或 Git Bash

1️⃣ 生成 SSH 密钥对

在终端执行以下命令，生成 RSA 密钥对。不要忘记用自己的邮箱替换 email。

ssh-keygen -t rsa -C "" -f ~/.ssh/github_key
# 或者使用更安全的 ed25519 算法
# ssh-keygen -t ed25519 -C "" -f ~/.ssh/github_key

上述命令会在 ~/.ssh/ 目录下创建两个文件：

• github_key — 私钥
• github_key.pub — 公钥

2️⃣ 将公钥添加到 GitHub 帐号中

如果你已经有了一个默认的，可以直接跳过这一步；否则请按以下步骤操作，

1. 打开浏览器登录 GitHub → 点击右上角头像 → Settings → SSH and GPG keys → New SSH key。
2. 将刚才生成的公钥内容粘贴到 “Key” 输入框中。说到示例格式如下，

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCy...

3. 为 Key 命名。接下来点击 Add SSH key。

3️⃣ 测试 SSH 连接是否成功

*提示*：如果你使用的是默认密钥名称，直接运行测试命令即可；不过，若使用自定义名称，需要额外配置。

ssh -T
# 成功时会看到类似：
# Hi username!You've successfully aunticated。but GitHub does not provide shell access.
# 如果出现 “Permission denied .”，说明密钥未被识别。

4️⃣ 自定义密钥文件时的常见问题与解决办法

A) 配置 ~/.ssh/config 文件

*痛点*：自定义密钥名称导致程序无法自动检测，从而出现“Permission denied”。 *

Host github-custom
HostName github.com
User git
IdentityFile ~/.ssh/github_key
IdentitiesOnly yes
# 添加远程仓库时使用自定义主机名：
git remote set-url origin git@github-custom:user/repo.git
# 测试：
ssh -T git@github-custom

B) 使用 ssh-agent 加载密钥

eval "$"
ssh-add ~/.ssh/github_key
# 添加远程仓库：
git remote set-url origin :user/repo.git
# 测试：
ssh -T

*注意*: 每次打开新的终端窗口，都需要重新执行上述两行命令来加载密钥。

C) 自动化脚本：把加载命令写进 .bashrc / .zshrc

echo 'eval "$"'>> ~/.bashrc
echo 'ssh-add ~/.ssh/github_key'>> ~/.bashrc
source ~/.bashrc # 或者重新打开终端

*提示*：如果你在 Windows 上使用 Git Bash，也可以将上述两行添加到 C:\Users\YourName\.bashrc  或 C:\Users\YourName\.profile  中。

5️⃣ 常见错误排查清单

• **SSH Agent 没有启动** — 运行 `eval "$"` 检查输出是否显示 PID。
• **私钥权限过宽** — `chmod 600 ~/.ssh/github_key`。
• **公钥未正确复制** — 确认没有多余空格或换行符，且完整粘贴到 GitHub。
• **网络代理拦截** — 检查公司 VPN 或代理设置是否阻止了 `` 的连接；话说回来，可以尝试 `-v` 查看调试信息。
• **GitHub 帐号已禁用两步验证导致密码失效** — 使用 SSH 而不是 HTTPS；或者生成新的 Personal Access Token 并配合 HTTPS 使用。
• **域名解析错误** — 确认 DNS 正确解析 github.com；尝试 `ping github.com` 或 `nslookup github.com` 验证。

6️⃣ 小结与常用方法建议

• 始终使用默认密钥位置和文件名。除非有特殊需求，否则无需改名，以免出现权限错误。)
• ~/.ssh/config是解决自定义密钥最简洁的方法，可一次性完成所有配置并避免每次手动加载。)
• chmod 600 必须保证私钥文件仅自己可读写，否则会被程序拒绝。)
• ~/.bashrc或~/.zshrc可以自动化 ssh-agent 启动和加载，提高工作效率。)
• -v 调试模式功能比较强，可以快速定位网络或权限问题。)`