首页 游戏 软件 资讯 排行榜 专题
首页
编程语言
Git怎么LFS管理大文件_Git LFS大文件存储使用教程【进阶】

Git怎么LFS管理大文件_Git LFS大文件存储使用教程【进阶】

热心网友
23
转载
2026-05-03

根本原因是git lfs install仅配置本地钩子,未将已跟踪的大文件重写进LFS轨道,需先git lfs track指定文件类型,再git rm --cached后重新add以转换为LFS指针。

Git怎么LFS管理大文件_Git LFS大文件存储使用教程【进阶】

免费影视、动漫、音乐、游戏、小说资源长期稳定更新! 👉 点此立即查看 👈

Git LFS初始化后push还是卡在大文件上

这事儿挺常见的:明明运行了 git lfs install,怎么推送大文件时还是慢如蜗牛,甚至失败?问题根源在于,那条命令仅仅是在本地配置了必要的钩子,它并不会“魔法般”地把仓库里已经存在的大文件自动迁移到LFS的轨道上。Git依然把它们当作普通文件来跟踪,推送时自然要传输完整的文件内容,瓶颈依旧。

所以,关键得手动把这些“漏网之鱼”纳入LFS的管理体系,并重新提交。具体步骤得按顺序来:

  • 首先,用 git lfs track "*.psd" 明确告诉Git哪些文件类型归LFS管(或者指定具体路径,比如 git lfs track "assets/large.zip")。这个操作会更新 .gitattributes 文件。
  • 紧接着,别忘了执行 git add .gitattributes。规则文件本身不提交,规则就不会生效。
  • 接下来是关键一步:对于已经被Git跟踪的大文件,需要用 git rm --cached 把它从暂存区移除(注意,这不会删除工作区里的实际文件),然后再用 git add 重新添加。这一次,Git就会根据 .gitattributes 里的规则,将其转换为一个轻量级的LFS指针文件。
  • 如果这些大文件在历史提交中已经存在了很久,涉及多次提交,那么就需要动用“历史重写”工具了:git lfs migrate import --include="*.zip"。不过得提醒一句,重写历史会影响所有协作者,操作后需要团队全员强制同步。

pull下来的是文本指针而不是真实文件

拉取代码后,发现本该是图片或模型的文件,打开却是一段奇怪的文本指针?别慌,这其实是LFS的正常工作机制。出现这种情况,通常意味着你的本地Git环境没有正确安装或启用LFS的“过滤器”(filter)。问题出在本地,而不是远程服务器,文件本身也没有损坏。

检查和修复的路径很清晰:

  • 先确认本机是否安装了Git LFS:运行 git lfs version,如果没有输出,就需要先安装(macOS用户可以用 brew install git-lfs,Windows用户建议从官网下载安装包)。
  • 安装后,运行 git lfs install(注意,不是init,clone操作也不会自动触发这个)。这个命令会在你的 .git/hooks/ 目录下部署必要的钩子,比如pre-push和post-checkout。
  • 如果你之前克隆仓库时没有启用LFS支持,现在可以直接运行 git lfs pull 来批量下载所有LFS管理的真实文件内容。当然,也可以针对单个文件使用 git lfs checkout
  • 额外注意:在某些持续集成(CI)环境或旧版本的Git中,可能需要显式启用过滤器,例如通过 -c filter.lfs.smudge=true 参数。

Git LFS上传失败报错"batch request failed: 401 Unauthorized"

代码推送(git push)明明成功了,但LFS文件上传却报401未授权错误?这往往不是你的仓库权限配置错了,而是凭证(token)过期了,或者没有正确地传递给LFS的服务端。Git和Git LFS使用了两套相对独立的认证流程:Git操作可能用的是SSH密钥或已缓存的密码,而LFS文件传输走的是独立的HTTP接口,需要特定的访问令牌。

常见的排查方向和解法如下:

  • 对于GitHub或GitLab,确保你使用的Personal Access Token包含了必要的权限。在GitHub上,需要 read:packageswrite:packages 权限;在GitLab上,通常需要 api 权限。仅靠账户密码或SSH密钥是不行的。
  • 可以尝试运行 git lfs install --force 来强制重置凭证存储的配置,然后用 git credential reject 命令清除旧的缓存凭据(需要指定host和protocol)。
  • 检查LFS的端点(endpoint)地址是否正确:运行 git config --get-regexp 'lfs.*url'。例如,GitHub的LFS端点通常是 https://github.com//.git/info/lfs,这和原始的Git仓库URL不同。
  • 如果是企业自建的Git服务器,需要确认服务器端是否部署了 git-lfs-authenticate 钩子,并且该钩子能返回有效的JWT令牌。

git clone 拉项目时跳过LFS文件下载

有时候,我们只想快速拉取代码结构进行查看,不想等待几百MB甚至几个GB的LFS资源(如图片、模型)慢慢下载完。这能做到吗?当然可以,核心思路是暂时关闭LFS的“smudge”(涂抹)过滤器。但必须清楚后果:这样做之后,所有本应由LFS管理的文件,在本地都只会显示为文本指针,无法直接打开或使用。

有两种相对可控的方式:

  • 在克隆时直接附加参数:git clone -c filter.lfs.smudge=false <仓库URL>。这样克隆下来的仓库,所有LFS文件都是指针。之后如果需要某个具体文件,再单独执行 git lfs pull --include="path/to/file.bin" 来下载。
  • 全局禁用(请谨慎使用):运行 git config --global filter.lfs.smudge false。这适合一些只读的CI构建任务,但在开发者的机器上这样设置,很容易导致误以为文件缺失。
  • 需要注意一个“陷阱”:即使关闭了smudge过滤器,运行 git status 命令时,工作区仍然会显示是干净的(clean),因为Git确实管理着那些指针文件本身。要验证一个文件是否已下载了真实内容,最直接的方法是查看文件大小,或者使用 file <文件名> 命令查看文件类型。

最后,理解Git LFS有一个至关重要的点:它并没有改变Git底层的对象模型,其本质只是用一个小型文本指针文件,替换了原本巨大的二进制文件对象(blob),并将真实内容托管到独立的服务器上。因此,它的整个工作流程高度依赖于本地钩子、正确的凭证以及网络连接这三者同时就位——任何一个环节断掉,都可能让你陷入“仓库看起来一切正常,但文件实际无法使用”的尴尬状态。

来源:https://www.php.cn/faq/2334207.html
免责声明: 游乐网为非赢利性网站,所展示的游戏/软件/文章内容均来自于互联网或第三方用户上传分享,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系youleyoucom@outlook.com。

相关攻略

VSCode终端设置_将默认PowerShell切换为Git Bash
编程语言
VSCode终端设置_将默认PowerShell切换为Git Bash

VSCode终端默认是PowerShell而非Git Bash,因PowerShell是Windows官方现代shell,具备更好系统集成能力;Git Bash为第三方兼容层,需手动配置路径并设为默认终端。 为什么 VSCode 终端默认是 PowerShell 而不是 Git Bash 很多开发者

热心网友
05.03
Git怎么查看文件在各版本间的变化_Git如何用diff对比两个commit的差异【命令】
编程语言
Git怎么查看文件在各版本间的变化_Git如何用diff对比两个commit的差异【命令】

Git怎么查看文件在各版本间的变化_Git如何用diff对比两个commit的差异【命令】 git diff 怎么对比两个 commit 的差异 最直接的方法,就是使用 git diff 。这条命令会清晰地展示从 到 这个区间内,所有文件发生了哪些增删改。换句话说,你看到的就是 相对于 所做的全部改

热心网友
05.03
Git怎么保留空文件夹_Git提交空目录的gitkeep方法【基础】
编程语言
Git怎么保留空文件夹_Git提交空目录的gitkeep方法【基础】

Git不跟踪空目录,因其只记录含文件的目录结构;最可靠方案是在空目录中添加 gitkeep空文件并提交。 简单来说,Git本身并不跟踪空目录。所谓的“保留空文件夹”,其实是一种变通手段——而其中最可靠、也最通用的做法,就是在空目录里放一个名为 gitkeep 的空文件。 为什么 Git 不保存空文

热心网友
05.03
如何在Notepad++中安装Git插件_Notepad++管理代码版本教程
编程语言
如何在Notepad++中安装Git插件_Notepad++管理代码版本教程

Notepad++ 与 Git 集成:告别插件幻想,拥抱高效协同 开门见山地说,如果你正在为 Notepad++ 寻找一个可用的 Git 插件,恐怕要失望了。事实是,Notepad++ 本身并不支持 Git 插件——市面上既没有官方出品,也缺乏稳定的第三方集成。那些所谓的“Git 插件”传闻,通常指

热心网友
05.03
Git怎么查看某行代码是谁写的_Git blame追溯代码作者教程【实战】
编程语言
Git怎么查看某行代码是谁写的_Git blame追溯代码作者教程【实战】

Git怎么查看某行代码是谁写的_Git blame追溯代码作者教程【实战】 git blame 怎么看某行是谁写的 想快速定位某行代码的“最后经手人”?直接用 git blame 就对了。这个命令的设计初衷就是干这个的——它不负责展示完整的项目日志,也不翻陈年旧账,而是精准地将文件中的每一行,映射到

热心网友
05.03

最新APP

宝宝过生日
宝宝过生日
应用辅助 04-07
台球世界
台球世界
体育竞技 04-07
解绳子
解绳子
休闲益智 04-07
骑兵冲突
骑兵冲突
棋牌策略 04-07
三国真龙传
三国真龙传
角色扮演 04-07

热门推荐

Composer如何配置自定义的类加载路径_在 autoload 的 files 字段定义【进阶】
编程语言
Composer如何配置自定义的类加载路径_在 autoload 的 files 字段定义【进阶】

Composer如何配置自定义的类加载路径_在 autoload 的 files 字段定义【进阶】 为什么加了 files 还是报 Call to undefined function 遇到这个问题,十有八九是源头就出了问题:入口文件压根没引入 vendor autoload php,或者引入的位置

热心网友
05.03
怎么用VSCode开发Electron程序-主进程与调试工具关联方法
编程语言
怎么用VSCode开发Electron程序-主进程与调试工具关联方法

VSCode 调试 Electron 主进程:告别“断点失效”,回归 Node js 本质 调试 Electron 主进程,核心思路其实很简单:把它当作一个特殊的 Node js 进程来对待。 关键在于,别再执着于 VSCode 里那个名为 “electron” 的调试类型,而是用 type: "n

热心网友
05.03
git回退到指定版本的操作步骤【详解】
编程语言
git回退到指定版本的操作步骤【详解】

git回退到指定版本的操作步骤【详解】 开门见山,先说结论:想把代码回退到某个特定版本,git reset --hard 无疑是速度最快、效果最彻底的方法。但请注意,这个“大招”有明确的适用范围:仅限于你的改动还没推送到远程仓库,或者你拥有强制覆盖远程分支的权限。一旦代码已经合入了团队共享的主干分支

热心网友
05.03
Atom编辑器有哪些必装插件_Atom编辑器常用插件推荐教程【经典】
编程语言
Atom编辑器有哪些必装插件_Atom编辑器常用插件推荐教程【经典】

Atom已停止维护,apm官方源失效,需改用社区镜像源(如https: apm atom io cn)或手动下载GitHub包安装;仍可用插件需满足不联网、不调API、无后端依赖等条件。 Atom编辑器在2022年底就正式告别了官方维护,这已经是公开的事实。但话说回来,它并没有从我们的硬盘里消失。

热心网友
05.03
Composer如何配置脚本仅在特定条件执行_Composer脚本特定条件执行配置大全
编程语言
Composer如何配置脚本仅在特定条件执行_Composer脚本特定条件执行配置大全

Composer脚本无法原生支持条件判断,因scripts字段仅将字符串交由系统shell执行,而CI中环境变量未导出、Windows语法不兼容、autoload未加载等问题导致if语句失败;应改用PHP回调函数显式检测环境变量并控制流程。 先说一个核心结论:Composer脚本本身不具备原生的条件

热心网友
05.03