GitCode大于50M文件上传解决方案

在 GitCode 或其他 Git 平台上遇到文件大小限制时（通常默认限制为 50MB），可以通过以下方法解决：

方法 1：使用 Git Large File Storage (LFS)

Git LFS 是专为管理大文件设计的工具，适合版本控制大型二进制文件（如图片、视频、数据集等）。

操作步骤：

1. 安装 Git LFS

   • 下载地址：https://git-lfs.github.com

   • 安装后运行初始化命令：

     git lfs install

2. 追踪大文件
   在仓库中指定要使用 LFS 管理的文件类型（例如 .psd、.zip 等）：

   git lfs track "*.zip"
   git lfs track "path/to/large-file.dat"

3. 提交 .gitattributes 文件
   Git LFS 会生成一个 .gitattributes 文件，需提交到仓库：

   git add .gitattributes
   git commit -m "启用 Git LFS 追踪大文件"

4. 正常推送文件
   添加大文件并推送，Git LFS 会自动处理：

   git add large-file.zip
   git commit -m "添加大文件"
   git push origin main

方法 2：从提交历史中移除大文件

如果已经误提交了大文件，需清理历史记录以解除限制。

操作步骤：

1. 使用 BFG Repo Cleaner 工具

   • 下载工具：BFG Repo-Cleaner

   • 删除超过 50MB 的文件：

     java -jar bfg.jar --strip-blobs-bigger-than 50M your-repo.git

2. 手动清理 Git 历史

   git filter-branch --tree-filter 'rm -f path/to/large-file' HEAD
   git push origin --force --all

方法 3：分割大文件

将大文件拆分为多个小于 50MB 的小文件。

操作步骤（Linux/macOS）：

1. 使用 split 命令分割文件：

   split -b 49M large-file.zip large-file-part-

2. 提交所有分割后的文件（如 large-file-part-aa, large-file-part-ab 等）。

方法 4：使用云存储替代

将大文件上传到云服务（如阿里云 OSS、腾讯云 COS、Google Drive 等），然后在仓库中保存文件链接。

注意事项

1. Git LFS 配额
   GitCode 的免费 LFS 配额可能有限，需检查平台的存储政策。

2. 清理历史记录的风险
   强制推送 (git push --force) 可能影响协作，需提前通知团队成员。

3. 备份
   操作前建议备份仓库。

总结建议

• 优先使用 Git LFS：适合长期维护的大文件。

• 紧急修复：若已误提交，用 BFG 或 git filter-branch 清理历史。

• 非代码文件：考虑云存储 + 链接方案。

按实际需求选择合适的方法即可解决文件大小限制问题。