删除 Git 历史提交记录中的大文件

git filter-branch 命令的作用是重写Git仓库历史记录,这里具体用于彻底删除大文件。该命令参数解析:

bash 复制代码
git filter-branch --force --index-filter "git rm --cached --ignore-unmatch multimodal-transport-system/data/road.geojson" --prune-empty --tag-name-filter cat -- --all

作用说明:

  1. --index-filter 会在每个历史提交中执行 git rm --cached 操作,从Git索引中永久删除:
    • multimodal-transport-system/data/road.geojson 指定要删除的路径
    • --ignore-unmatch 允许文件不存在时跳过报错
  2. --prune-empty 会自动删除因删除文件而产生的空提交
  3. --tag-name-filter cat 会保留并重写所有标签(tag)
  4. --all 表示对所有分支进行操作

最终效果:该文件会从所有分支的历史提交记录中被清除(包括已推送的远程记录),但本地工作目录中的实际文件不受影响。执行后需要使用 git push --force 强制覆盖远程仓库历史。

注意:这会改变项目历史哈希值,执行前请确保已备份仓库,且提前通知所有协作者需要重新克隆仓库。

相关推荐
Joy T25 分钟前
【Web3】Hardhat工程架构中Solidity与TypeChain的协作机制
git·架构·typescript·web3·智能合约·hardhat·typechain
步十人26 分钟前
【Git】基础概念与在vscode中的简单使用
git
代码中介商26 分钟前
Git 版本控制完全指南:从分支管理到远程协作
linux·git
无风听海8 小时前
git fsck 深度解析 Git 仓库的体检医生
git
洋仔15 小时前
Git 底层原理系列 · 第8讲 — HEAD 与 detached HEAD
git·开源
洋仔15 小时前
Git 底层原理系列 · 第4讲 — `git add` 与 `git commit` 底层做了什么
git·开源
猫咪老师QAQ17 小时前
基于 Git Flow 的团队协作与发布流程实践
git
caicai_xiaobai17 小时前
分享一个访问Git Hub的好方法
git
Joy T18 小时前
【Web3】跨链资金池与消息路由:CCIP 智能合约集成实战与权限收束
git·web3·node·智能合约·hardhat
難釋懷19 小时前
Nginx虚拟主机
git·nginx·github