LFS怎样恢复数据

按这个顺序操作，可最大程度找回丢失或被误删的 LFS 大文件。

一、快速诊断与定位

• 检查本地对象是否缺失或损坏
  运行：git lfs fsck，常见输出包括：missing object: （本地缓存被删）、pointer file does not exist（指针文件损坏）、corrupted object（对象校验失败）。该命令会遍历指针与本地对象进行一致性校验。

• 查看工作区是否只剩“指针文本”
  典型指针内容以如下片段开头（包含 version 与 oid sha256:…）：
  version https://git-lfs.github.com/spec/v1
  oid sha256:4e9a3…
  size 1234567
  若工作区文件体积异常小且内容类似上述文本，说明指针未正确“smudge”为真实二进制。

• 查看 LFS 操作日志
  日志路径：.git/lfs/commands.log，有助于定位失败阶段与对象 OID。

二、恢复路径 A 远程仓库仍完好

• 拉取缺失对象

  • 拉取全部：git lfs fetch --all
  • 拉取指定提交范围：git lfs fetch origin master --include="design/*.psd"
  • 拉取指定对象：git lfs fetch origin <commit-hash>
  • 拉取指定 OID：git lfs fetch colleague --object-id=<missing-oid>（将同事仓库临时添加为远程）
    以上命令会按需从远程获取缺失的 LFS 对象到本地缓存。

• 将对象签出到工作区

  • 通用：git lfs checkout（在 Git LFS 3.0+ 已标记为 deprecated，但在紧急恢复时依然有效）
  • 或：git lfs pull（等价于 fetch + checkout 的组合）
    完成后确认大文件已恢复实际内容而非指针文本。

三、恢复路径 B 远程也缺失或对象被删除

• 从本地历史重建指针并重新下载

  • 列出包含目标文件的提交：git log --pretty=format:%H -- "path/to/large-file.psd"
  • 从历史版本导出原始指针内容：git show <commit-hash>:path/to/large-file.psd
  • 将输出保存为同名文件，替换损坏/缺失的指针文件
  • 执行 git lfs pull 重新拉取对应 OID 的二进制对象
    该流程适用于指针损坏或服务器侧对象被删除但本地历史仍保留指针内容的场景。

• 从其他克隆仓库迁移对象

  • 添加同事仓库为临时远程：git remote add colleague <url>
  • 按 OID 拉取：git lfs fetch colleague --object-id=<missing-oid>
  • 批量迁移可直接拷贝同事仓库的 .git/lfs/objects 到本地，然后执行：git lfs dedup（去重/硬链复用）
    适用于团队其他成员本地缓存仍完整的情形。

• 对象确实已被删除且无可追溯来源
  若远程与所有克隆均不再保留该 OID 的二进制对象，通常无法恢复。此时只能从备份或原始介质找回，再重新 git add 并 git lfs push 到服务器。

四、常见报错与修复要点

• “Object does not exist on the server / 404”
  说明仓库中仍有指针，但服务器侧 LFS 对象不存在。若有原始文件：

  • cp 原始文件 xxx.data → git add xxx.data → git lfs push <remote> <branch> --all → git checkout xxx.data
    若无原始文件，则无法恢复该对象。

• “Encountered X file(s) that may not have been copied correctly / smudge 错误”
  处理步骤：

  • 确认安装并初始化：git lfs version、git lfs install
  • 分步恢复：git lfs fetch --all 再 git lfs checkout 或 git lfs pull
  • 开启调试日志定位：GIT_TRACE=1 GIT_LFS_TRACE=1 git lfs pull
  • 检查网络稳定性与带宽限制。

• “LFS object missing / corrupted object”
  先 git lfs fsck 确认缺失/损坏的 OID，再按“路径 A/B”从远程、历史或其他克隆恢复对象。

五、恢复后的加固与预防

• 多远程与多端备份

  • 推送时双写：git lfs push --all origin && git lfs push --all backup
  • 为关键仓库配置备份远程，降低单点故障风险。

• 定期完整性校验

  • 本地/CI 中加入：git lfs fsck --strict，并保存校验报告，及时发现对象缺失或损坏。

• 规范清理与权限管控

  • 删除 LFS 资源需通过平台或管理员界面执行，避免仅删工作区文件导致指针残留与后续推送/浏览异常。