0

0

GitHub 怎么上传大文件?大文件上传限制与解决方案

舞姬之光

舞姬之光

发布时间:2026-02-26 10:56:02

|

840人浏览过

|

来源于php中文网

原创

github拒绝推送超100mb文件,可行方案有四:一、用git lfs跟踪大文件;二、拆分大文件为≤95mb子文件后提交;三、通过github releases托管(单个附件上限2gb);四、用github cli命令行上传release附件。

github 怎么上传大文件?大文件上传限制与解决方案

如果您尝试将大于 100 MB 的文件推送到 GitHub 仓库,系统会拒绝提交并提示“large files detected”,这是因为 GitHub 对单个文件有严格的大小限制。以下是应对该限制的多种可行方案:

一、使用 Git LFS 替代原生 Git 跟踪大文件

Git LFS(Large File Storage)通过将大文件内容存储在远程服务器上,仅在本地仓库保留轻量指针文件,从而绕过 GitHub 原生的文件大小限制。

1、在项目根目录执行 git lfs install 初始化 LFS。

2、运行 git lfs track "*.psd" 命令声明需由 LFS 管理的文件类型(可替换为 .zip、.mp4 等扩展名)。

3、执行 git add .gitattributes 将 LFS 配置文件纳入暂存区。

4、添加目标大文件后,运行 git add 文件名git commit -m "add large file via LFS"

5、推送时,LFS 文件将自动上传至 GitHub 的 LFS 服务端,主仓库仅保留指针。

二、拆分大文件为多个子文件后分别提交

对于不可用 LFS 处理的场景(如二进制资源包需保持完整性但无法启用 LFS),可借助归档工具将单个超限文件分割为多个符合 GitHub 限制的片段,再统一提交。

1、使用 split -b 95M largefile.zip largefile_part_ 在 Linux/macOS 下将文件切分为小于 100 MB 的块。

2、在 Windows 上可使用 7-Zip,设置“分割压缩文件为”并指定 95 MB 作为单个卷大小。

3、对每个生成的分卷文件(如 largefile_part_aa、largefile_part_ab)执行 git add 并提交。

Descript
Descript

一个多功能的音频和视频编辑引擎

下载

4、向仓库 README.md 中添加明确说明:请使用 cat 或 copy 命令合并分卷后解压

三、改用 GitHub Releases 托管大文件资产

GitHub Releases 功能允许为每个发布版本附加独立于 Git 历史的二进制文件,单个附件上限为 2 GB,且不计入仓库克隆体积。

1、在仓库页面点击 Releases → Draft a new release

2、填写标签版本号与发布标题,勾选 This is a pre-release(如适用)。

3、在描述框下方拖入目标大文件,或点击 Attach binaries by dropping them here

4、完成编辑后点击 Publish release,文件即托管成功并生成永久下载链接。

四、通过 GitHub CLI 上传 Release 附件(命令行方式)

当需自动化发布流程或处理 CI/CD 场景中的大文件交付时,GitHub CLI 提供了直接上传 Release 附件的能力,避免网页操作依赖。

1、确保已安装 GitHub CLI 并执行 gh auth login 完成身份认证。

2、创建新发布:运行 gh release create v1.0.0 --title "v1.0.0" --notes "Release with large asset"

3、上传附件:执行 gh release upload v1.0.0 ./largefile.bin,CLI 将自动识别版本并上传。

4、验证上传结果:访问对应 Release 页面,确认 largefile.bin 已出现在“Assets”区域。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
github中文官网入口 github中文版官网网页进入
github中文官网入口 github中文版官网网页进入

github中文官网入口https://docs.github.com/zh/get-started,GitHub 是一种基于云的平台,可在其中存储、共享并与他人一起编写代码。 通过将代码存储在GitHub 上的“存储库”中,你可以: “展示或共享”你的工作。 持续“跟踪和管理”对代码的更改。

2851

2026.01.21

自建git服务器
自建git服务器

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

915

2023.07.05

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

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

575

2023.07.06

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

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

273

2023.07.24

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

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

567

2024.04.09

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

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

532

2024.04.09

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1281

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1154

2023.07.27

batoto漫画官网入口与网页版访问指南
batoto漫画官网入口与网页版访问指南

本专题系统整理batoto漫画官方网站最新可用入口,涵盖最新官网地址、网页版登录页面及防走失访问方式说明,帮助用户快速找到batoto漫画官方平台,稳定在线阅读各类漫画内容。

331

2026.02.25

热门下载

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

精品课程

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

共21课时 | 3.9万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.6万人学习

Git中文开发手册
Git中文开发手册

共0课时 | 94人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号