已提交node_modules致Git推送失败，如何彻底移除并完成推送？

问题根源 #

你之前的提交已经把node_modules目录写入了Git历史，仅通过git rm --cached取消追踪或添加.gitignore，无法清除历史记录里的大文件，所以推送时仍会触发限制。

分场景解决 #

场景1：包含node_modules的是最后一次提交

操作最简单，直接回退并重做提交：

1. 回退到上一次提交（保留本地文件修改）：

   git reset HEAD^
   

2. 彻底删除本地的node_modules（之后可以用npm install重新安装）：

   rm -rf node_modules
   

3. 确认.gitignore里已经添加了node_modules/，然后重新提交：

   git add .
   git commit -m "你的提交描述"
   

4. 重新推送：

   git push -u origin main
   

场景2：包含node_modules的是更早的历史提交

需要改写整个Git历史，彻底移除node_modules的记录：

1. 执行命令清除历史中所有node_modules的追踪记录：

   git filter-branch --force --index-filter 'git rm -r --cached --ignore-unmatch node_modules' --prune-empty --tag-name-filter cat -- --all
   

2. 强制推送到远程仓库（注意：如果是多人协作项目，强制推送会覆盖远程历史，务必提前告知协作成员）：

   git push origin main --force
   

3. 清理本地冗余的Git对象，释放空间：

   rm -rf .git/refs/original/
   git reflog expire --expire=now --all
   git gc --prune=now --aggressive
   

后续注意事项 #

• 确保.gitignore文件里始终存在node_modules/，避免以后再误提交依赖目录。
• 推送前可以用git status检查是否有意外追踪的文件，或者用git ls-files确认node_modules是否已被排除。

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