Git仓库存在缺失LFS对象，如何迁移到新仓库且不使用LFS保留原文件？

以下两种方案都可以实现剥离LFS、直接存储实际文件的迁移需求，均不需要找回丢失的LFS对象：

方案一：使用Git LFS官方导出工具（操作最简单） #

该方案使用Git LFS自带的migrate export能力，直接将全量历史中的LFS指针替换为实际二进制文件：

• 第一步：拉取旧仓库的完整镜像

  git clone --mirror <旧仓库地址>
  cd <克隆下来的镜像仓库目录>
  

• 第二步：配置Git LFS跳过缺失对象检查，避免拉取时报错

  git config lfs.skipmissingobjects true
  

• 第三步：拉取所有可获取的LFS对象到本地缓存

  git lfs fetch --all
  

• 第四步：执行全量历史的LFS导出，将指针替换为实际文件

  git lfs migrate export --everything --include="*"
  

  遇到丢失的LFS对象时，命令会提示对应文件路径，你可以选择手动替换为占位文件，或直接保留原有指针文件即可，不会中断迁移流程
• 第五步：删除仓库内所有LFS相关配置
  删除.gitattributes文件中所有带filter=lfs的规则，删除.git/config中所有[lfs]开头的配置段。

方案二：使用git filter-repo重写历史（灵活度最高） #

如果方案一执行报错，可使用功能更强大的git filter-repo工具自定义重写逻辑：

• 第一步：完成方案一的前3步，拉取镜像、配置跳过缺失LFS对象、拉取所有可获取的LFS对象到本地
• 第二步：执行历史重写，遍历所有提交中的文件，将LFS指针替换为本地缓存中的实际二进制文件，找不到对应LFS对象的文件统一替换为占位内容
  示例过滤逻辑可参考：识别文件开头为version https://git-lfs.github.com/spec/v1的LFS指针，提取指针中的oid值，到本地LFS缓存目录（默认路径为.git/lfs/objects/）匹配对应文件，匹配成功则替换指针，匹配失败则写入该LFS对象已丢失的占位文本。
• 第三步：删除仓库内所有LFS相关配置，同方案一第五步。

最终推送至新仓库 #

两种方案处理完成后，执行以下命令推送至新仓库即可：

• 绑定新仓库地址

  git remote add new-origin <新仓库地址>
  

• 推送全部分支

  git push new-origin --all
  

• 推送全部标签

  git push new-origin --tags
  

注意事项 #

• 操作前务必备份原始镜像仓库，避免误操作损坏原始数据
• 仓库体积大、历史提交多的情况下，迁移耗时较长，可先拿单个测试分支验证流程再执行全量迁移
• 若丢失的LFS对象对应的文件无需保留，可在重写历史时直接删除对应文件，减少新仓库的体积

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