VSCode大文件无法提交到GitHub怎么解决

云婷君_4364

云婷君_4364

2026-07-15

683人浏览

原创

github单个文件超100mb被拒是硬性限制,须用git lfs解决:先执行git lfs install,再git lfs track指定文件类型,最后提交.gitattributes并add大文件,顺序错误将导致lfs失效。

vscode大文件无法提交到github怎么解决

GitHub拒绝大于100MB的文件,不是VSCode的问题

VSCode本身不限制文件大小,真正卡住的是GitHub的服务器策略:单个文件超过100MB会被git push直接拒绝,报错类似remote: error: File xxx.zip is 124.50 MB; this exceeds GitHub's file size limit of 100.00 MB。这不是配置错误,也不是代理或认证问题,是硬性限制。

用Git LFS托管大文件,三步走通

Git LFS(Large File Storage)是官方推荐方案,它把大文件替换成指针,实际内容存到LFS服务器。关键点不在VSCode操作,而在终端里执行以下命令:

  • 先安装LFS:git lfs install(只需一次,全局生效)
  • 声明要追踪的大文件类型,比如:git lfs track "*.psd" 或 git lfs track "data/model.bin" —— 注意路径要匹配你实际文件位置
  • 提交.gitattributes(LFS自动生成):git add .gitattributes,再git commit -m "track large files via lfs"

之后再git add那些大文件,它们就会被LFS接管。推送时不会报100MB错,但需确保远程仓库已启用LFS(新建仓库默认支持,老仓库不用额外操作)。

别用git push -f硬推,会破坏LFS关联

有人试过加-f强制推送大文件,结果是:虽然看似成功,但LFS指针没上传,别人git clone下来拿到的是空壳文件,根本打不开。更糟的是,git lfs ls-files会显示missing状态,修复成本远高于重来。

GitHub Actions Cache Hardening Audit
GitHub Actions Cache Hardening Audit

审计 GitHub Actions 工作流缓存的投毒、密钥泄露和密钥路径风险

下载

如果已经误推过,得彻底清理:

  • 删掉本地大文件和.gitattributes中对应行
  • 运行git rm --cached <file></file>(不删工作区)
  • 重新git lfs track并提交.gitattributes
  • 再git add <file></file> → git commit → git push

替代方案:纯手动传,绕过Git

如果只是偶尔传一个模型/数据集,且不需版本历史,最省事的方式是放弃Git:

  • 把大文件单独压缩成.zip或.tar.gz
  • 去GitHub仓库页面 → Releases → Draft a new release → 在“Attach binaries”里拖入上传
  • 这样文件挂在Release下,链接稳定,下载不限速,也不占Git历史体积

注意:Release附件不能用git clone拉取,得手动下载,适合交付物而非源码依赖。

真正容易被忽略的是git lfs track必须在git add之前执行——顺序反了,大文件就进普通Git对象库了,后续补救极麻烦。

相关专题

更多
自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

2023.07.05

5419

9

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

2023.07.06

1640

6

git撤销提交的commit
git撤销提交的commit

Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。

2023.07.24

954

5

git提交错误怎么撤回
git提交错误怎么撤回

git提交错误撤回的方法:git reset head^:撤回最后一次提交,恢复到提交前状态。git revert head:创建新提交,内容与之前提交相反。git reset :使用提交的 sha-1 哈希撤回指定提交。交互式舞台区:标记要撤回的特定更改,然后提交,排除已撤回更改。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.09

3537

7

git怎么对比两个版本的文件内容
git怎么对比两个版本的文件内容

要对比两个版本的 git 文件,请使用 git diff 命令:git diff 比较工作树和暂存区之间的差异。git diff 比较两个提交或标签之间的差异。git diff 输出显示差异块,其中 + 表示添加的行,- 表示删除的行, 表示修改的行。可使用 gitkraken、meld、beyond compare 等可视化工具更直观地查看差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.09

3201

6

vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1215

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

2492

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1849

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1707

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程