跳至主要内容

配置 Git 大型文件存储

一旦安装了 Git LFS,你需要将其与存储库中的一个大文件关联。

平台导航

如果你存储库中已有要与 GitHub 配合使用的现有文件,则需要先将它们从存储库中移除,然后在本地将它们添加到 Git LFS。有关详细信息,请参阅“将存储库中的文件移动到 Git 大文件存储”。

如果存在未成功上传的 Git LFS 文件引用,你将收到一条错误消息。有关详细信息,请参阅“解决 Git 大文件存储上传失败问题”。

  1. 打开 终端终端Git Bash

  2. 将当前工作目录更改为要与 Git LFS 配合使用的现有存储库。

  3. 若要将存储库中的文件类型与 Git LFS 关联,请输入 git lfs track,后跟要自动上传到 Git LFS 的文件扩展名的名称。

    例如,若要关联一个 .psd 文件,请输入以下命令

    $ git lfs track "*.psd"
    > Tracking "*.psd"
    

    要与 Git LFS 关联的每种文件类型都需要使用 git lfs track 添加。此命令会修改存储库的 .gitattributes 文件,并将大文件与 Git LFS 关联。

    注意:我们强烈建议你将本地 .gitattributes 文件提交到存储库。

    • 当向其他 Git 项目贡献时,依赖与 Git LFS 关联的全局 .gitattributes 文件可能会导致冲突。
    • .gitattributes 文件包含在存储库中,可以让创建分支或新克隆的人更轻松地使用 Git LFS 进行协作。
    • .gitattributes 文件包含在存储库中,允许在 ZIP 文件和 tarball 存档中包含 Git LFS 对象(可选)。
  4. 向存储库中添加与你已关联的扩展名匹配的文件

    git add path/to/file.psd
    
  5. 提交文件并将其推送到 GitHub

    git commit -m "add file.psd"
    git push
    

    你应该会看到一些有关文件上传的诊断信息

    > Sending file.psd
    > 44.74 MB / 81.04 MB  55.21 % 14s
    > 64.74 MB / 81.04 MB  79.21 % 3s
    

延伸阅读