GitHub上传大文件方法

在 GitHub 上发布一个开源项目时，我上传了一个用于灵活配置的自定义相机库（支持拍照和视频录制），并提交了一个超过 200M 的 gif 文件。尽管 commit 成功，但在 push 时却频繁报错，错误提示大致如下：

1、 GitHub不支持直接上传超过100M的大文件至远程仓库，这是导致错误的常见原因。如需提交大文件，可启用Git LFS（Large File Storage），通过安装并初始化LFS，将大文件交由其管理，再进行正常提交操作即可解决。

2、 在本地安装git-lfs工具

3、 选择需要由Git LFS管理的文件类型，或直接修改.gitattributes文件。后续可随时添加其他文件扩展名配置。完成此步骤后，系统将自动生成一个gitattributes文件。

4、 添加.gitattributes文件并提交到版本控制中。

5、 将大文件添加至本地缓存区域

6、 需注意：上述为官网操作流程，但我未按此执行。若照此操作，仍可能出现推送失败的情况（所示），建议参考我提供的解决方案。

7、 参考解决方案

8、 前两步保持不变，第三步中先生成.gitattributes文件，将其添加、提交并推送到远程分支，待合并完成后，再将大文件添加、提交并推送至同一分支，确保操作顺序正确，避免冲突，保障文件顺利上传。整个流程严谨有序，符合版本控制规范，有效管理大文件的纳入与同步。

9、 需先将.gitattributes配置文件提交并推送到远程仓库，再上传大文件，务必注意操作顺序，避免因顺序错误导致大文件未被正确追踪处理。

10、 部分同学已提交大文件但未提交.gitattributes，需进行版本回退操作，建议参考相关教程中的版本回退指南完成处理，确保提交内容符合规范要求。

11、 来源：简书