如何在缺失文件时从Git LFS迁移至普通Git仓库？

先做备份，别搞砸了 #

先完整复制你的本地仓库目录，留好备份，操作错了还能回滚：

cp -r your-repo-dir your-repo-dir-backup

写个处理LFS指针的脚本 #

直接建个replace-lfs-pointers.sh脚本，给它加执行权限：

touch replace-lfs-pointers.sh
chmod +x replace-lfs-pointers.sh

把下面的内容丢进去——脚本会遍历每个提交里的文件，识别LFS指针，优先用仓库最新提交（HEAD）里的实际文件替换指针；如果最新提交里也找不到这个文件，就直接删掉指针：

#!/bin/bash

# 遍历当前提交下的所有文件
find . -type f | while read -r file; do
    # 检查是不是LFS指针（开头匹配LFS规范）
    if head -n1 "$file" | grep -q "version https://git-lfs.github.com/spec/v1"; then
        # 试试从HEAD里拿这个文件的实际内容
        if git show HEAD:"$file" > /dev/null 2>&1; then
            # 拿得到就替换指针为实际文件
            git show HEAD:"$file" > "$file"
        else
            # 拿不到就删掉这个指针文件
            rm -f "$file"
        fi
    fi
done

用filter-branch重写所有提交 #

运行下面的命令，让脚本处理所有分支的每一次提交：

git filter-branch --tree-filter './replace-lfs-pointers.sh' -- --all

这个命令会逐个遍历所有提交，把每个提交里的LFS指针要么换成实际文件，要么直接删掉，彻底移除LFS依赖。

清理临时垃圾 #

处理完之后，删掉Git生成的临时引用和日志，释放空间：

git for-each-ref --format="%(refname)" refs/original/ | xargs -n 1 git update-ref -d
git reflog expire --expire=now --all
git gc --prune=now

验证+推新仓库 #

• 先确认所有LFS指针都处理完了：

find . -type f -exec head -n1 {} \; | grep "version https://git-lfs.github.com/spec/v1"

如果没输出，说明所有指针都搞定了。

• 然后加新仓库地址，把重写后的历史推上去：

git remote add new-origin <你的新仓库URL>
git push new-origin --all
git push new-origin --tags

可选优化：用最近存在的版本替换 #

如果不想只用HEAD的版本，而是想用该文件最后一次出现的提交版本来替换，可以把脚本里的那段逻辑改成下面这样：

#!/bin/bash

# 遍历当前提交下的所有文件
find . -type f | while read -r file; do
    # 检查是不是LFS指针（开头匹配LFS规范）
    if head -n1 "$file" | grep -q "version https://git-lfs.github.com/spec/v1"; then
        # 找到包含这个文件的最近一次提交哈希
        latest_commit=$(git log --all --follow --format="%H" -- "$file" | head -n1)
        if [ -n "$latest_commit" ]; then
            # 用最近提交的实际文件替换指针
            git show "$latest_commit":"$file" > "$file"
        else
            # 完全找不到就删掉指针文件
            rm -f "$file"
        fi
    fi
done

这样能更精准地保留文件的有效版本，而不是硬套HEAD的内容。

注意：git filter-branch会彻底重写所有提交历史，要是仓库有其他协作的人，记得让他们弃用旧仓库，直接克隆新仓库的历史。

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