已启用Git LFS仍触发GitHub大文件检测错误,求排查方案
解决Git LFS推送大文件报错的问题
第一步:确认dev-status分支的.gitattributes配置
先检查当前dev-status分支下是否存在正确的.gitattributes文件:
cat .gitattributes
如果该文件不存在,从main分支同步配置:
git checkout main -- .gitattributes git add .gitattributes git commit -m "同步LFS大文件追踪配置"
第二步:重写分支历史,替换原始大文件为LFS指针
dev-status分支的历史提交中可能仍保留未被LFS追踪的原始大文件,需要重写历史完成替换:
- 确保Git LFS已本地初始化(未执行过则运行):
git lfs install
- 明确追踪目标大文件:
git lfs track "etc/ffmpeg-6.1-amd64-static"
- 重写dev-status分支的历史,替换指定大文件为LFS指针:
git lfs migrate import --include="etc/ffmpeg-6.1-amd64-static" --branch=dev-status
第三步:强制推送重写后的分支
由于重写了分支历史,需要强制推送覆盖远程分支:
git push origin dev-status --force
注意:强制推送会覆盖远程的dev-status分支,若有其他协作者在该分支工作,需提前沟通确认
验证操作结果
推送完成后,运行以下命令确认大文件已被LFS正确追踪:
git lfs ls-files
如果目标文件出现在输出列表中,说明配置生效。
内容的提问来源于stack exchange,提问作者vy32
相关产品推荐
相关产品推荐

