首页/开发/Git 与协作速查/把既有大文件迁移进 LFS
进阶与大仓实践69 条

把既有大文件迁移进 LFS

git lfs migrate import 把历史提交中的匹配文件改写为 LFS 指针;先 migrate info 查看候选与体积,再决定是否重写历史。

Git 与协作速查开发更新于 2026-10-12
分析git lfs migrate info --everything
迁移git lfs migrate import --include='*.psd' --everything
影响历史提交被改写,所有相关哈希变化

迁移流程

迁移流程
git lfs migrate info --everything
git lfs migrate import --include='*.psd' --everything
git push --force-with-lease --all
git push --force-with-lease --tags
历史改写需要团队协调:所有克隆要重新拉取或按迁移文档处理,旧提交哈希在外部链接里会失效。

易错点

  • 在本地临时分支上先演练迁移,确认体积与哈希影响后再对主仓库执行
  • 迁移后没有强推或未通知团队,会造成新旧历史并存、互相覆盖

数据来源与参考

  • Git LFS 官方文档:git-lfs migrate(import/info)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌