首页/开发/Git 与协作速查/git lfs 安装与大文件跟踪
进阶与大仓实践69 条

git lfs 安装与大文件跟踪

用 Git LFS 把大文件(模型、素材、二进制包)存到外部存储,仓库里只保留指针;git lfs install 配置钩子,git lfs track 声明模式。

Git 与协作速查开发更新于 2026-10-12
安装git lfs install(写入本地钩子与配置)
跟踪git lfs track '*.psd'(写入 .gitattributes)
检查git lfs ls-files 查看已被 LFS 管理的文件

常用示例

常用示例
git lfs install
git lfs track '*.psd' '*.zip'
git add .gitattributes assets/design.psd
git commit -m 'chore: 启用 LFS 跟踪设计文件'
track 只影响后续提交:已经在普通对象里的大文件需要 migrate 才能转成 LFS(见迁移条目)。

易错点

  • 忘记提交 .gitattributes 时其他人克隆后不会走 LFS,文件又会以普通对象入库
  • 团队成员未安装 LFS 时指针会以文本形式检出,代码里容易出现无法打开的占位文件

数据来源与参考

  • Git LFS 官方文档:git-lfs install / track(git-lfs.com)
  • Git 官方文档:gitattributes(filter=lfs)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌