如何删除Git历史中除最近n条提交外的所有记录以节省存储空间

以下操作默认你要保留的最近提交数为N，比如需求里的4条就把N替换为4即可，操作前建议先完整复制一份仓库做冷备份，避免误操作丢数据。

方法一：浅克隆替换法（最推荐，清理最彻底，零冲突） #

这个方法不会残留旧版本的冗余对象，操作完仓库体积最小，也不会出现变基冲突问题，适合备份类的个人仓库场景。

• 进入原仓库的上级目录，执行浅克隆命令，只拉取最近N条提交：
  git clone --depth N file:///原仓库的本地绝对路径 新临时仓库名

注意本地路径必须加file://前缀，否则部分Git版本不会正确截断历史。比如原仓库路径是/d/backup/sys-config，要保留4条提交，新仓库叫sys-config-new，命令就写git clone --depth 4 file:///d/backup/sys-config sys-config-new

• 进入新生成的临时仓库，执行git log --oneline检查提交列表，确认只有最近N条记录，同时核对文件内容和原仓库最新状态一致。
• 确认无误后，关闭所有正在访问原仓库的程序，把临时仓库里的.git文件夹替换掉原仓库内的.git文件夹即可。
• 如果需要把清理后的历史推送到远程仓库，执行强制推送覆盖旧历史即可：
  git push --force origin 你的分支名

多人协作仓库不要随便执行强制推送，否则会打乱其他协作者的提交历史，仅建议个人备份类仓库使用这个方法。

方法二：原仓库内直接操作（无需新建目录） #

如果不想额外生成新的仓库目录，可以直接在原仓库内操作，这个方法适合需要保留最近N条提交记录的场景：

• 先执行git status确认工作区干净，没有未提交的改动。
• 先拿到最近N条提交里最早一条的父提交哈希，执行git rev-parse HEAD~N可以直接拿到这个值，记为BASE_COMMIT_ID。
• 执行替换命令，把这个BASE_COMMIT_ID替换成空提交，也就是截断它之前的所有历史：
  git replace $BASE_COMMIT_ID $(git commit-tree -m "截断旧历史" $BASE_COMMIT_ID^{tree})
• 执行历史重写，让替换永久生效：
  git filter-repo --force

如果你的Git没有自带git-filter-repo，需要先安装对应包，这个工具比旧的filter-branch速度快很多，也不容易出错。

• 最后执行垃圾回收，彻底删除旧的冗余对象，缩小仓库体积：

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

附加：仅保留当前文件状态，清空所有历史（只留1条初始提交） #

如果你不需要保留最近N条的提交记录，只需要保证当前文件不丢失、所有历史全部清空，可以用更简单的孤儿分支法：

• 创建无父提交的孤儿分支：git checkout --orphan latest_branch
• 暂存所有当前文件：git add -A
• 提交初始版本：git commit -m "清除旧历史，初始化备份仓库"
• 删除原来的旧主分支（如果你的主分支叫master就把下面的main换成master）：git branch -D main
• 把当前新分支重命名为主分支名：git branch -m main
• 执行上面提到的垃圾回收命令清理冗余数据即可，需要推远程同样执行强制推送。

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