如何从Git仓库中删除大文件并解决推送错误方案

情景说明
当你尝试推送一个包含超大文件(如war包)到Git仓库时,可能会遇到类似“文件大小超过限制”的错误。本教程将指导你如何从Git历史中删除这样的大文件,以便能够成功推送至远程仓库。以下步骤以Gitee为例,但同样适用于GitHub、GitLab等其他平台。
第一步:识别问题文件
获取文件SHA:根据错误信息,首先运行Gitee提供的命令来定位问题文件的SHA值。

` git filter-branch --force --index-filter 'git rm --cached --ignore-unmatch 文件路径' --prune-empty --tag-name-filter cat -- --all

将“文件路径”替换为实际的文件路径,例如src/main/webapp/myapp.war
等待完成:此过程可能需要一段时间,具体取决于仓库的大小。
第三步:清理与优化
清理临时文件:执行以下命令以删除过滤过程中产生的临时文件。

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

检查仓库大小:可选地,使用du -sh .git查看仓库大小是否减小。
第四步:强制推送更改
推送分支:由于历史已被修改,需要使用--force强制推送。

git push origin --force --all

推送标签:如果有标签涉及被修改的提交,也需要强制推送标签。

`git push origin --force --tags

第五步:
重要提醒:在执行完上述操作后,所有仓库的协作者都需要在本地执行git fetch --allgit reset --hard origin/分支名,以更新到最新的仓库状态。这是因为历史被重写了,原来的分支指向不再有效。
注意事项
数据安全:在开始之前,请确保已备份好你的本地仓库,以防操作失误导致数据丢失。
协作影响:强制推送会覆盖远程分支历史,务必与团队成员沟通,避免造成工作冲突。
远程设置:部分Git服务允许调整单个仓库的大小限制,如果频繁遇到此类问题,考虑调整这些设置或寻找更适合存储大文件的解决方案,如Git LFS(Large File Storage)。

相关推荐

最近更新

  1. docker php8.1+nginx base 镜像 dockerfile 配置

    2024-07-11 00:40:06       101 阅读
  2. Could not load dynamic library ‘cudart64_100.dll‘

    2024-07-11 00:40:06       108 阅读
  3. 在Django里面运行非项目文件

    2024-07-11 00:40:06       91 阅读
  4. Python语言-面向对象

    2024-07-11 00:40:06       98 阅读

热门阅读

  1. Git删除了文件拉取时失败

    2024-07-11 00:40:06       26 阅读
  2. 学习测试练习题

    2024-07-11 00:40:06       30 阅读
  3. QT log日志

    2024-07-11 00:40:06       32 阅读
  4. Angular页面项目以HTTPS方式启动调试

    2024-07-11 00:40:06       25 阅读
  5. ArduPilot开源飞控之AP_VisualOdom

    2024-07-11 00:40:06       22 阅读
  6. 如何实现跨域

    2024-07-11 00:40:06       25 阅读
  7. centos7yum-mysql-community-server安装流程步骤

    2024-07-11 00:40:06       28 阅读
  8. toFixed 四舍五入问题

    2024-07-11 00:40:06       24 阅读
  9. [C++][CMake][嵌套的CMake]详细讲解

    2024-07-11 00:40:06       22 阅读
  10. 65.指针函数和函数指针

    2024-07-11 00:40:06       26 阅读
  11. 网络安全测评技术与标准

    2024-07-11 00:40:06       28 阅读
  12. Qt之多线程编程(QThread)

    2024-07-11 00:40:06       28 阅读
  13. MySQL:left join 后用 on 还是 where?

    2024-07-11 00:40:06       25 阅读
  14. 最短路径算法(算法篇)

    2024-07-11 00:40:06       25 阅读