目录
为什么会发生推送失败？
步骤1：检查并配置SSH密钥
生成新SSH密钥
添加公钥到GitHub
测试SSH连接
步骤2：验证Git远程URL
步骤3：配置Git用户名和邮箱
步骤4：排查网络和权限问题
步骤5：处理推送失败的具体错误
常见错误及修复
步骤6：如果使用HTTPS协议的认证问题
步骤7：其他高级排查
为什么会发生推送失败？
在旧电脑上，一切顺风顺水，但换到新电脑后，GitHub推送失败的主要原因包括：
SSH密钥未配置或失效：GitHub默认使用SSH协议进行安全认证。新电脑没有旧密钥，自然无法验证身份。
远程URL配置错误：可能是HTTPS vs SSH的混淆，或者URL拼写有误。
Git全局配置缺失：用户名、邮箱等基本信息未设置，导致提交无效。
网络或权限问题：防火墙、代理、仓库权限等外部因素。
认证方式变更：GitHub已弃用密码认证，转而使用个人访问令牌（PAT）或SSH。
其他杂项：Git版本过旧、分支冲突等。
这些问题看似复杂，但通过系统排查，通常能在几分钟内解决。下面，我将每个步骤详细展开，包括命令、解释和注意事项。
步骤1：检查并配置SSH密钥
SSH密钥是GitHub推送的核心安全机制。如果新电脑上没有密钥，推送就会报"Permission denied (publickey)"错误。
生成新SSH密钥
打开终端（Windows用Git Bash，macOS/Linux用默认终端）。
执行命令生成密钥对（推荐使用Ed25519算法，更安全）：
复制代码
ssh-keygen -t ed25519 -C "your_email@example.com"
-t ed25519：指定算法类型。
-C "your_email@example.com"：添加注释，通常用你的GitHub邮箱。
按回车接受默认路径（~/.ssh/id_ed25519），然后设置密码（可选，但推荐用于额外安全）。如果已有密钥，命令会提示覆盖------小心别覆盖旧的！
添加公钥到GitHub
查看公钥内容：
复制代码
cat ~/.ssh/id_ed25519.pub
复制输出的全部内容（从ssh-ed25519开始，到邮箱结束）。
登录GitHub网站，点击右上角头像 > Settings > SSH and GPG keys > New SSH key。
粘贴公钥，添加标题（如"New Laptop Key"），点击Add SSH key。
测试SSH连接
执行：
复制代码
ssh -T git@github.com
成功输出：Hi your_username! You've successfully authenticated, but GitHub does not provide shell access.
如果失败，检查密钥路径是否正确，或防火墙是否阻挡端口22。
注意 ：如果用代理，确保SSH配置支持代理（如在~/.ssh/config中添加ProxyCommand）。
步骤2：验证Git远程URL
远程URL决定了推送协议。SSH更安全可靠，HTTPS则需额外认证。
查看当前远程URL：
复制代码
git remote -v
正确SSH示例：origin git@github.com:your_username/your_repo.git (push)
如果是HTTPS（如https://github.com/...），建议切换到SSH以避免认证麻烦。
切换到SSH（如果需要）：
复制代码
git remote set-url origin git@github.com:your_username/your_repo.git
替换为你的实际仓库地址。
提示 ：用git clone时，优先选择SSH链接（GitHub仓库页面的"Code"按钮下）。
步骤3：配置Git用户名和邮箱
这些是提交的身份标识，未设置会导致推送拒绝。
设置全局配置：
复制代码
git config --global user.name "Your Name"
git config --global user.email "your_email@example.com"
用你的GitHub用户名和邮箱替换。
验证配置：
复制代码
git config --list
确保user.name和user.email正确。
常见坑 ：如果仓库有本地配置（非全局），用--local选项检查/设置。
步骤4：排查网络和权限问题
网络不稳或权限不足是隐形杀手。
测试网络连通性：
复制代码
ping github.com
如果超时，检查VPN、防火墙或DNS设置。
确认仓库权限：登录GitHub，进入仓库 > Settings > Collaborators，确保你的账号有写权限（如果是私有仓库或组织项目）。
如果在公司网络，咨询IT是否屏蔽了Git端口（SSH:22，HTTPS:443）。
步骤5：处理推送失败的具体错误
直接尝试推送，记录错误：
复制代码
git push origin main
（假设你的分支是main；如果是master，用相应名称。）
常见错误及修复
Permission denied (publickey)：返回步骤1，重配SSH。
Repository not found：检查URL拼写，或仓库是否被删除/私有化。
SSL certificate problem ：代理或证书问题。临时禁用验证（不推荐长期用）：
复制代码
git config --global http.sslVerify false
更好方案：更新CA证书或配置代理。
fatal: The current branch has no upstream branch ：设置上游分支：
复制代码
git push --set-upstream origin main
error: failed to push some refs ：分支冲突，拉取更新：
复制代码
git pull origin main
然后再推。如果需覆盖，谨慎用--force：
复制代码
git push origin main --force
步骤6：如果使用HTTPS协议的认证问题
SSH失败时，可 fallback 到HTTPS，但GitHub已禁用密码认证。
生成个人访问令牌（PAT）：
GitHub > Settings > Developer settings > Personal access tokens > Tokens (classic) > Generate new token。
勾选repo权限（全仓库访问），生成并复制令牌（只会显示一次！）。
配置凭据助手（让Git记住令牌）：
复制代码
git config --global credential.helper store
推送时，用户名输入你的GitHub用户名，密码输入PAT。
安全提醒：PAT如密码，勿泄露。定期轮换。
步骤7：其他高级排查
检查Git版本：
复制代码
git --version
如果低于2.30，升级Git（macOS: brew install git；Windows: 下载官网安装包）。
分支冲突或大文件 ：用git status检查未提交变更；大文件用Git LFS。
调试模式 ：加-v参数推送：
复制代码
git push -v origin main
获取更多日志。