Skip to main content

配置 Git Large File Storage

安装 Git LFS 后,需要将其与存储库中的大型文件相关联。

Platform navigation

如果仓库中存在要用于 GitHub 的现有文件,则需要先从仓库中删除它们,然后在本地将其添加到 Git LFS。 有关详细信息,请参阅“将仓库中的文件移至 Git Large File Storage”。

如果有引用的 Git LFS 文件未成功上传,您将收到一条错误消息。 有关详细信息,请参阅“解决 Git Large File Storage 上传失败”。

  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 相关联。

    Note

    强烈建议你将本地 .gitattributes 文件提交到存储库中。

    • 如果依赖与 Git LFS 关联的全局 .gitattributes 文件,可能会导致在参与其他 Git 项目时发生冲突。
    • 在存储库中包含 .gitattributes 文件允许创建分支或新克隆的人员更轻松地使用 Git LFS 进行协作。
    • 在存储库中包含 .gitattributes 文件允许将 Git LFS 对象选择性地包含在 ZIP 文件和 tarball 存档中。
  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
    

其他阅读材料