使用git push同步VS Code代码至GitHub时遭遇HTTP 500错误求助

问题诊断 #

从错误日志能看到你推送的数据包达到了7.57 GiB，这已经远超GitHub通过HTTP协议推送的大小限制，直接导致了RPC failed; HTTP 500和远程连接断开的问题。

解决方案 #

1. 清理仓库中的大文件 #

首先定位并移除仓库里的超大文件：

• 找出仓库中体积最大的5个对象：

  git verify-pack -v .git/objects/pack/*.idx | sort -k 3 -n | tail -5
  

• 如果是不小心提交的大文件（比如压缩包、视频、大型数据集），彻底从历史中删除（替换path/to/large-file为实际文件路径）：

  git filter-repo --path path/to/large-file --invert-paths
  

• 把这些大文件添加到.gitignore，避免再次提交。

2. 调整Git的HTTP推送配置 #

增大Git的HTTP缓存和超时阈值，提升大文件推送的容错性：

git config --global http.postBuffer 524288000
git config --global http.maxRequestBuffer 100M
git config --global http.lowSpeedLimit 0
git config --global http.lowSpeedTime 999999

3. 切换到SSH协议推送 #

HTTPS协议对大文件推送限制更严格，改用SSH协议可避免这类问题：

• 查看当前远程仓库地址：git remote -v
• 替换为SSH地址（替换成你的用户名和仓库名）：

  git remote set-url origin git@github.com:your-username/your-repo.git
  

4. 拆分提交内容 #

如果确实需要推送大量内容，不要一次性提交所有修改，拆分多个小提交分批推送：

• 比如先提交部分文件夹：git add dir1 dir2 && git commit -m "Add dir1 and dir2"，推送后再处理剩余内容。

优化你的推送脚本 #

原脚本无错误处理，拉取或提交失败时会继续执行后续命令，修改后增加错误判断：

#!/bin/zsh

commit_message="Commit changes"

# 拉取远程代码，失败则终止脚本
git pull || exit 1

# 检查是否有需要提交的变更
git add .
if git diff --cached --quiet; then
    echo "没有需要提交的变更"
    exit 0
fi

# 提交变更，失败则终止
git commit -m "$commit_message" || exit 1

# 推送变更，失败则终止
git push || exit 1

内容的提问来源于stack exchange，提问作者cryptomamy