Git推送大对象文件故障：配置.gitignore后仍推送venv依赖包

问题根源 #

.gitignore只对未被Git追踪的文件生效。你之前已经把.venv里的文件提交到Git历史中了，所以后续加.gitignore、删除本地.venv文件夹都没用——Git推送时会同步所有历史提交里的对象，包括那些早已存入历史的大文件。

解决方案步骤 #

1. 彻底清除Git历史中的.venv文件

方法一：用git filter-repo（官方推荐，替代旧的filter-branch）

• 先备份整个仓库文件夹（避免操作失误丢失数据）
• 执行命令重写历史，移除所有提交中的.venv文件夹：

git filter-repo --path .venv --invert-paths

方法二：正确使用BFG Repo Cleaner

之前操作没效果大概率是用法不对，按以下步骤来：

• 创建一个文本文件big-files.txt，内容为：

.venv/

• 执行BFG命令删除历史中的指定文件：

java -jar bfg-1.14.0.jar --delete-files big-files.txt

• 清理Git冗余对象：

git reflog expire --expire=now --all && git gc --prune=now --aggressive

2. 优化.gitignore配置

你当前的.gitignore规则重复，可以简化成：

# Python虚拟环境
.venv/

# Python编译文件
*.py[cod]

# BFG工具文件
bfg-1.14.0.jar

3. 强制推送修改后的历史

因为重写了Git历史，需要强制覆盖远程仓库的历史：

git push origin master --force

⚠️ 提示：如果有其他协作者，他们需要重新克隆仓库，或者执行git pull --rebase同步修改后的历史，否则会出现冲突。

4. 后续预防

• 提前配置.gitignore：在创建虚拟环境之前，就把.venv加入.gitignore，避免被Git追踪
• 用requirements.txt管理依赖：执行pip freeze > requirements.txt记录依赖，其他人通过pip install -r requirements.txt安装，不要提交虚拟环境文件夹

内容的提问来源于stack exchange，提问作者Kadir Can Üzümcü