如何仅截断特定文件的Git历史以缩减.git仓库占用体积

首先明确：完全支持仅清理指定文件的Git历史，无需对整个分支做截断操作，操作后可直接缩小.git目录体积，以下是具体实现步骤：

前置操作 #

• 操作前对整个仓库做全量备份，避免误操作丢失数据
• 通知所有团队成员暂停提交，操作完成后需所有人重新克隆新的仓库，避免旧历史被重新推送回远程

方案1：完全删除指定文件的所有历史记录 #

官方推荐使用git filter-repo工具（比传统的git filter-branch效率高10倍以上，对大仓库更友好）：

1. 安装git filter-repo（多数新版Git发行版已默认集成，无集成可通过包管理器直接安装）
2. 克隆裸仓库到本地执行操作：

git clone --bare 你的仓库地址 repo-temp
cd repo-temp

3. 执行清理：
   • 清理单个固定路径的文件：
     git filter-repo --path 目标文件的完整路径 --invert-paths
   • 批量清理同一后缀的所有二进制文件（例：所有.pak格式文件）：
     git filter-repo --path-glob '*.pak' --invert-paths
4. 清理完成后强制推送到远程仓库：

git push origin --force --all
git push origin --force --tags

操作完成后即可看到本地和远程的.git仓库体积大幅下降。

方案2：仅截断指定文件的早期历史，保留近期版本 #

如果不需要完全删除该文件的所有历史，仅要删除某时间点之前的历史，可通过git filter-repo的回调功能实现，示例为删除2023年1月1日之前的指定文件历史：

git filter-repo --path 目标文件路径 --commit-callback "
if commit.author_date < b'2023-01-01 00:00:00 +0800':
    commit.file_changes = [fc for fc in commit.file_changes if fc.filename != b'目标文件路径']
"

长期优化建议 #

针对高频更新的二进制文件，后续推荐使用Git LFS管理，可从根源避免仓库体积膨胀问题，配置仅需两步：

1. 开启LFS跟踪指定类型文件：git lfs track "*.pak"
2. 提交生成的.gitattributes文件到仓库即可，后续该类文件都会自动走LFS存储。

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