前置条件

• 已安装 Git
• 已注册 GitHub 账号
• 在 GitHub 上创建空的远程仓库

使用者痛点一这方面。SSH Key 没有配置好导致 “Permission denied ” 错误

很多人第一次使用 GitHub 时直接用 HTTPS 推送，结果在公司网络上被代理拦截，或者在家里忘记开启 SSH 服务，导致常见的权限错误。说起来，下面先帮你快速检查并生成 SSH Key。不过，

从第一步先来看。检查本地 SSH 密钥

macOS 默认的密钥方法为 /Users/yourname/.ssh/id_rsa 和 /Users/yourname/.ssh/id_rsa.pub。先确认是否已有：

ls -la ~/.ssh/
# 如果看到 id_rsa 和 id_rsa.pub 则已有

如果没有密钥。立即生成一对：

ssh-keygen -t rsa -b 4096 -C ""
# 一路回车就可以使用默认方法

复制公钥内容并添加到 GitHub：

cat ~/.ssh/id_rsa.pub
# 将输出内容完整复制
# 登录 GitHub → Settings → SSH and GPG Keys → New SSH Key → 粘贴并保存

使用者痛点二这方面，公司或校园网络封禁标准 SSH 端口导致推送失败

当你看到“Connection timed out”或“Could not resolve hostname”，很可能是因为默认的 22 端口被防火墙拦截。可以让 SSH 使用 HTTPS 的端口来绕过限制。

从接下来来看，配置 SSH Config

Edit your SSH config file:

vi ~/.ssh/config
# 添加下面内容：
Host github.com
Hostname ssh.github.com
Port 443
User git
IdentityFile ~/.ssh/id_rsa
IdentitiesOnly yes

说明的观点是。

• Hostname ssh.github.com: GitHub 提供的支持 HTTPS 的域名。
• Port 443: HTTPS 通常不会被阻断。
• User git + IdentityFile: 指定使用你的私钥。
• IDentitiesOnly yes: 防止客户端尝试其他未授权密钥。

使用者痛点三这方面，SSH 验证失败后仍出现“Permission denied ” 或 “Connection refused”错误怎么办？

# 检查公钥是否已正确上传到 GitHub；# 确认 ~/.ssh/config 中的 Hostname 与 Port 正确；# 在终端执行 `ssh -T ` 看是否得到欢迎信息。 如果还是失败，请重新生成密钥并 添加。

：测试 SSH 连接成功与否

ssh -T 

Hi <用户名>!You've successfully aunticated,but GitHub does not provide shell access. 若未成功请根据错误提示排查。

常见错误解释 - Permission denied – 公钥未上传或配置文件方法错误。- Connection timed out – 网络代理或防火墙阻塞了指定端口。其实，

从第四步来看，设置远程仓库地址并推送代码 🚀

• 首次添加远程仓库：

git remote add origin :<用户名>/<仓库名>.git

已有远程地址想切换到 SSH：
git remote set-url origin :<用户名>/<仓库名>.git

验证远程地址是否正确：
git remote -v
# 应该显示：
origin :<用户名>/<仓库名>.git
origin :<用户名>/<仓库名>.git

首次推送： 
git push --set-upstream origin main # 或 master。根据项目主分支命名

# 后续只需 `git push` 就可以完成同步。

至于附录，HTTPS 推送方式 👇

If you still encounter issues after configuring SSH。you can temporarily switch to HTTPS.

1. Create/Use an existing Personal Access Token on GitHub:
   - Go to Settings → Developer settings → Personal access tokens → Generate new token. - Select scopes “repo” for full repository access.
2. Add or change remote URL to HTTPS:

# Set remote URL to HTTPS:
git remote set-url origin https://github.com/<用户名>/<仓库名>.git

git push --set-upstream origin main

Please remember that plain password auntication is disabled on GitHub since August 2021.

快速操作清单📋

bash #!/usr/bin/env bash set -e ## Step 1 Generate key if missing echo '🔑 检测/生成SSH Key…' if，n ssh-keygen -t rsa -b 4096 -C \"$@$\" <<$' Enter passphrase : ' fi ## Step 2 Copy public key and add to clipboard PUB=$ echo \"复制以下内容后粘贴至GitHub: $PUB\" | pbcopy echo '✅ 公钥已复制到剪贴板，请打开GitHub→Settings→SSH+GPG Keys→New Key粘贴。 ' ## Step 3 Optional – Configure port‑over‑HTTPS if behind strict firewall if command -v netstat>/dev/null && netstat -an | grep ':22'>/dev/null;n :，else echo '⚠️ 若网络封禁22端口，请手动编辑~/.ssh/config';fi ## Step 4 Add/set remote URL echo '🔧 设置远程URL…' git remote add origin :$USER/$REPO.git || \\ git remote set-url origin :$USER/$REPO.git echo '✅ 已设置远程URL:' $ ## Step 5 Push code echo '🚀 推送代码…' git push --set-upstream origin main || { echo '❌ 推送失败，请检查网络和权限';exit 1 } 脚本仅演示流程，请根据实际环境自行调整 bash …老实说， "}