最近提交代码时，Gitee 把 push 拦下来了。

原因很直接：有个大文件超过限制，提示大概是 100MB 这一 类 。

我一开始以为很简单：把文件删掉，再提交一次。

结果还是失败。

后来才反应过来，Git 不是只看当前目录。这个大文件只要曾经被 commit 过，即使后来删了，它还在 Git 历史里。Gitee 检查到历史对象里有超限文件，照样拒绝。

嵌入式项目很容易踩这个坑。

固件包、`bin`、`hex`、`elf`、`map`、 SDK 压缩包、抓包日志、客户现场日志，一次 `git add .` 就可能混进去。

## 1、先判断文件有没有进历史

如果只是暂存，还没提交：

```bash
git restore --staged path/to/big-file.bin
```

然后加到 `.gitignore`：

```text
build/
output/
*.bin
*.hex
*.elf
*.map
*.zip
*.7z
*.log
*.pcap
```

如果已经 commit 过，就不是删文件这么简单了。

![](https://developer.qcloudimg.com/http-save/yehe-8201782/da04d55099cf8420182e93703be3fb7d.png)

## 2、找出历史里的大文件

Git Bash 可以用：

```bash
git rev-list --objects --all |
git cat-file --batch-check="%(objecttype) %(objectname) %(objectsize) %(rest)" |
grep "^blob" |
sort -k3 -n |
tail -20
```

PowerShell 可以用：

```powershell
git rev-list --objects --all |
  git cat-file --batch-check="%(objecttype) %(objectname) %(objectsize) %(rest)" |
  Select-String "^blob" |
  Sort-Object { [int64](($_ -split "\\\\s+")[2]) } |
  Select-Object -Last 20
```

看见 `build/xxx.elf`、`release/xxx.zip`、`xxx.bin` 这类路径，就基本知道问题在哪了。

## 3、只在最后一次提交里，直接改最后一次提交

如果大文件只在最后一次 commit 里：

```bash
git rm --cached path/to/big-file.bin
git add .gitignore
git commit --amend
git push
```

`--cached` 表示只从 Git 里移除，本地文件还在。

## 4、已经进多次历史，用 filter-repo 清掉

安装：

```bash
pip install git-filter-repo
```

清理指定文件：

```bash
git filter-repo --path path/to/big-file.bin --invert-paths
```

清理整个构建目录：

```bash
git filter-repo --path build/ --invert-paths
```

清理本地对象：

```bash
git gc --prune=now --aggressive
```

推送：

```bash
git push --force-with-lease origin main
```

如果是团队仓库，先通知大家暂停提交。改写历史后，最好让成员重新克隆，别各自乱 rebase。

## 5、大文件以后放哪里

不要把 Git 当网盘。

| 文件 | 建议位置 |
| --- | --- |
| 固件发布包 | Gitee Release 或制品库 |
| 编译生成的 `bin/hex/elf` | CI 产物 |
| SDK 压缩包 | 文件服务器，文档写版本和哈希 |
| 抓包、日志、波形 | 问题单附件或日志服务器 |
| 必须版本化的大资源 | Git LFS |

Git LFS 可以用，但不是万能药。

已经进普通 Git 历史的大文件，不会因为你执行 `git lfs track` 就自动消失。该清历史还是要清。

后来才反应过来，Git 不是只看当前目录。这个大文件只要曾经被 commit 过，即使后来删了，它还在 Git 历史里。Gitee 检查到历史对象里有超限文件，照样拒绝。

超过100MB的大文件Gitee提交失败，怎么解决？

大文件已经进入Git历史时，仅删除工作区文件不足以解决推送失败。本文说明如何定位大对象、修改最后一次提交、清理历史，并选择合适的大文件存储方式。

嵌入式工程师

开发工具

Gitee提交被拒通常因大文件已进入Git历史，即使删除后仍占用存储空间。本文详解彻底清理方法：先用`git rev-list`定位历史大文件，再通过`git filter-repo`移除或使用`git rm --cached`处理最后一次提交，最后强制推送并通知团队成员重新克隆。同时推荐将固件包、日志等大文件迁移至Gitee Release或GitLFS，避免再次触发限制。

让每一个 Agent，都跑在云上

coding

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Gitee提交被拒通常因大文件已进入Git历史，即使删除后仍占用存储空间。本文详解彻底清理方法：先用`git rev-list`定位历史大文件，再通过`git filter-repo`移除或使用`git rm --cached`处理最后一次提交，最后强制推送并通知团队成员重新克隆。同时推荐将固件包、日志等大文件迁移至G...

超过100MB的大文件Gitee提交失败，怎么解决？-腾讯云开发者社区-腾讯云

超过100MB的大文件Gitee提交失败，怎么解决？

超过100MB的大文件Gitee提交失败，怎么解决？

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐