如何彻底清除仓库中所有Git LFS痕迹？解决迁移LFS缺失报错

要完全移除仓库（含所有历史记录）的Git LFS痕迹，需重写整个提交历史并替换所有LFS指针为实际文件内容，具体步骤如下：

前置准备 #

• 备份本地仓库：复制整个仓库文件夹到安全位置，避免操作失误导致数据丢失。
• 拉取所有LFS对象到本地，确保历史中的LFS文件都已下载：

  git lfs pull --all
  

步骤1：安装git-filter-repo工具 #

git-filter-repo是官方推荐的历史重写工具，比旧的git-filter-branch更高效可靠：

• Debian/Ubuntu：sudo apt install git-filter-repo
• macOS（Homebrew）：brew install git-filter-repo
• Windows：pip install git-filter-repo（需先安装Python环境）

步骤2：重写历史，替换LFS指针为实际文件 #

执行以下命令，遍历所有提交历史，将LFS指针文件替换为对应的实际文件内容：

git filter-repo --blob-callback '
import re
lfs_pattern = re.compile(br"^version https://git-lfs.github.com/spec/v1\noid sha256:[0-9a-f]{64}\nsize \d+\n$")
if lfs_pattern.match(blob.data):
    oid = re.search(br"oid sha256:([0-9a-f]{64})", blob.data).group(1).decode()
    lfs_path = f".git/lfs/objects/{oid[:2]}/{oid[2:4]}/{oid}"
    with open(lfs_path, "rb") as f:
        blob.data = f.read()
' --force

步骤3：清理LFS相关配置与文件 #

• 删除仓库根目录.gitattributes中所有LFS追踪规则，若文件仅包含LFS配置可直接删除该文件。
• 移除本地仓库的LFS配置：

  git lfs uninstall --local
  

• 删除本地LFS存储目录：

  rm -rf .git/lfs
  

步骤4：强制推送重写后的历史 #

由于已修改所有提交历史，需强制覆盖远程仓库：

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

注意：强制推送会彻底替换远程仓库的历史，需提前告知团队成员，所有成员需重新克隆仓库，旧本地仓库将无法与远程同步。

验证 #

克隆新的仓库副本，执行以下操作确认LFS已完全移除：

• git lfs ls-files：无任何输出
• 检查历史中的大文件：文件内容为实际数据而非LFS指针

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