git-lfs

Git 大文件存储扩展

补充说明

git-lfs 把大文件内容存到 LFS 服务端，仓库里只保留指针文件。它适合模型、图片、视频和二进制包；不装 LFS 时克隆到的只是指针。

常用示例

git lfs install
git lfs track '*.psd'
git add .gitattributes
git add design.psd
git commit -m 'add design'
git lfs ls-files
git lfs status
git lfs pull
git lfs push origin main
git lfs fetch --all
git lfs prune
git lfs migrate import --include='*.zip' --everything

易错点与排错

• .gitattributes 必须提交；否则其他人克隆后不会走 LFS。
• 没装 LFS 时克隆得到的是几行文本指针，不是真实文件。
• git lfs migrate 会改写历史；执行前备份并通知所有协作者。
• LFS 有存储和流量配额；大文件反复推送会快速消耗额度。
• CI 需要开启 LFS 检出（如 lfs: true），否则构建拿到指针文件。
• git lfs prune 只删本地缓存，不影响远端；但会影响离线使用。
• 文件锁适合二进制协作，但需要服务端支持；不是所有托管平台都启用。
• 已提交到普通 Git 历史的大文件不会自动转 LFS；要先用 migrate。

相关命令

• git — 版本控制
• git-archive — 导出发布包