误执行git lfs migrate import后，旧提交显示LFS指针而非文件diff如何修复？

核心逻辑 #

git lfs migrate import会重写仓库所有历史提交，把目标文件替换成LFS指针。要让旧提交恢复显示实际文件内容，得用git lfs migrate export反向操作，把不该由LFS管理的文件从历史里还原，同时保留原本需要LFS托管的大文件。

具体操作步骤 #

• 明确需要保留LFS的文件：先梳理清楚原本就该由LFS管理的文件类型或路径，比如*.psd、*.zip这类大体积文件。
• 执行反向迁移命令：
  根据你的需求选对应的命令：
  • 若知道只有特定文件需要LFS（比如*.bin和*.iso），就指定这些文件保留LFS，其余还原：

    git lfs migrate export --include="*.bin,*.iso" --everything
    

  • 若要排除所有不该用LFS的文件（比如代码文件*.py、*.js、文档*.md）：

    git lfs migrate export --exclude="*.py,*.js,*.md" --everything
    

  其中--everything表示处理所有分支、标签的历史提交。
• 验证修复结果：用git show <旧提交哈希>查看任意旧提交，确认显示的是实际文件内容而非LFS指针。
• 强制推送（谨慎操作）：因为重写了历史，需要强制覆盖远程仓库：

  git push --force
  

  注意：强制推送会覆盖远程历史，必须提前通知所有协作成员，让他们重新拉取仓库并同步本地代码，避免冲突。

• 清理冗余LFS对象（可选）：如果有不再需要的LFS对象，可清理本地和远程的冗余数据：

  git lfs prune
  git lfs push --all origin
  

重要提醒 #

• 如果在误执行git lfs migrate import前有本地备份或远程仓库的备份，优先从备份恢复，这是最安全的方案。
• 强制推送前务必和团队成员沟通，避免造成协作混乱。

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