跳至主要内容

关于 Git 大文件存储

GitHub 限制了仓库中允许的文件大小。要跟踪超出此限制的文件,可以使用 Git 大文件存储。

关于 Git 大文件存储

Git LFS 通过在仓库中存储文件的引用来处理大文件,而不是存储文件本身。为了解决 Git 架构的限制,Git LFS 创建了一个指针文件,该文件充当实际文件(存储在其他位置)的引用。GitHub 在您的仓库中管理此指针文件。当您克隆仓库时,GitHub 会使用指针文件作为映射,为您找到大文件。

根据您的 GitHub 计划,Git LFS 适用不同的最大大小限制。

产品最大文件大小
GitHub 免费版2 GB
GitHub Pro2 GB
GitHub Team4 GB
GitHub Enterprise Cloud5 GB

如果超出每个文件的 5 GB 限制,Git LFS 会拒绝该文件并显示错误消息。

您也可以将 Git LFS 与 GitHub Desktop 一起使用。有关在 GitHub Desktop 中克隆 Git LFS 仓库的更多信息,请参阅“从 GitHub 克隆仓库到 GitHub Desktop”。

您可以选择是否将 Git LFS 对象包含在 GitHub 为您的仓库创建的源代码存档(如 ZIP 文件和 tarball)中。有关更多信息,请参阅“管理仓库存档中的 Git LFS 对象”。

指针文件格式

Git LFS 的指针文件如下所示

version https://git-lfs.github.com/spec/v1
oid sha256:4cac19622fc3ada9c0fdeadb33f88f367b541f38b89102a3f1261ac81fd5bcb5
size 84977953

它跟踪您正在使用的 Git LFS 的version(版本),后跟文件的唯一标识符(oid)。它还存储最终文件的大小(size)。

注意

  • Git LFS 不能与 GitHub Pages 站点一起使用。
  • Git LFS 不能与模板仓库一起使用。

进一步阅读