本文详细介绍了Git LFS的工作原理和使用方法，帮助开发者管理Git仓库中的大文件。Git LFS通过将大文件替换为指针文件，减少克隆时的数据传输，提高效率。文章涵盖了安装、创建、克隆、拉取、跟踪文件等操作，并提供了加快克隆和拉取速度的技巧。此外，还讨论了文件锁定和清理本地Git LFS缓存的方法。
作者：terryshchen，腾讯 IEG 应用开发工程师
本文主要讲解在 Git 仓库中如何管理大的二进制文件，详细介绍了什么是 Git LFS，Git LFS 是如何工作的，以及如何使用 Git LFS。
本文翻译自 Atlassian 官方介绍 Git LFS 的文章，Atlassian 是 Git LFS 的主要开发者之一，这篇介绍 Git LFS 的文章比较权威，讲的也很详细。原文地址：
https://www.atlassian.com/git/tutorials/git-lfs
本文同时也加了我个人的一些注释，注释内容会明确用蓝色字体标识出来。
什么是 Git LFS？
Git 是分布式 版本控制系统，这意味着在克隆过程中会将仓库的整个历史记录传输到客户端。对于包含大文件（尤其是经常被修改的大文件）的项目，初始克隆需要大量时间，因为客户端会下载每个文件的每个版本。Git LFS（Large File Storage）是由 Atlassian, GitHub 以及其他开源贡献者开发的 Git 扩展，它通过延迟地（lazily）下载大文件的相关版本来减少大文件在仓库中的影响，具体来说，大文件是在 checkout 的过程中下载的，而不是 clone 或 fetch 过程中下载的（这意味着你在后台定时 fetch 远端仓库内容到本地时，并不会下载大文件内容，而是在你 checkout 到工作区的时候才会真正去下载大文件的内容）。
Git LFS 通过将仓库中的大文件替换为微小的指针（pointer） 文件来做到这一点。在正常使用期间，你将永远不会看到这些指针文件，因为它们是由 Git LFS 自动处理的：
\1. 当你添加（执行 git add 命令）一个文件到你的仓库时，Git LFS 用一个指针替换其内容，并将文件内容存储在本地 Git LFS 缓存中（本地 Git LFS 缓存位于仓库的.git/lfs/objects 目录中）。
\2. 当你推送新的提交到服务器时，新推送的提交引用的所有 Git LFS 文件都会从本地 Git LFS 缓存传输到绑定到 Git 仓库的远程 Git LFS 存储（即 LFS 文件内容会直接从本地 Git LFS 缓存传输到远程 Git LFS 存储服务器）。
\3. 当你 checkout 一个包含 Git LFS 指针的提交时，指针文件将替换为本地 Git LFS 缓存中的文件，或者从远端 Git LFS 存储区下载。
关于 LFS 的指针文件：
LFS 的指针文件是一个文本文件，存储在 Git 仓库中，对应大文件的内容存储在 LFS 服务器里，而不是 Git 仓库中，下面为一个图片 LFS 文件的指针文件内容：
version https://git-lfs.github.com/spec/v1
oid sha256:5b62e134d2478ae0bbded57f6be8f048d8d916cb876f0656a8a6d1363716d999
size 285
指针文件很小，小于 1KB。其格式为 key-value 格式，第一行为指针文件规范 URL，第二行为文件的对象 id，也即 LFS 文件的存储对象文件名，可以在.git/lfs/objects 目录中找到该文件的存储对象，第三行为文件的实际大小（单位为字节）。所有 LFS 指针文件都是这种格式。
Git LFS 是无缝的：在你的工作副本中，你只会看到实际的文件内容。这意味着你不需要更改现有的 Git 工作流程就可以使用 Git LFS。你只需按常规进行 git checkout、编辑文件、git add 和 git commit。git clone 和 git pull 将明显更快，因为你只下载实际检出的提交所引用的大文件版本，而不是曾经存在过的文件的每一个版本。
为了使用 Git LFS，你将需要一个支持 Git LFS 的托管服务器，例如Bitbucket Cloud或Bitbucket Server（GitHub、GitLab也都支持 Git LFS）。仓库用户将需要安装 Git LFS 命令行客户端（参考这里其实更好），或支持 Git LFS 的 GUI 客户端，例如Sourcetree。
安装 Git LFS
\1. 有三种简单的方式来安装 Git LFS：
a. 用你最喜欢的软件包管理器来安装它。git-lfs 软件包在 Homebrew，MacPorts，dnf 和packagecloud中都是可用的；或者
b. 从项目网站下载并安装Git LFS；
c. 安装 Sourcetree，它是捆绑了 Git LFS 的一个免费的 Git GUI 客户端。
\2. 一旦安装好了 Git LFS，请运行 git lfs install 来初始化 Git LFS（如果你安装了 Sourcetree，可以跳过此步骤）：
$ git lfs install
Git LFS initialized.
你只需要运行 git lfs install 一次。为你的系统初始化后，当你克隆包含 Git LFS 内容的仓库时，Git LFS 将自动进行自我引导启用。
创建一个新的 Git LFS 仓库
要创建一个新的支持 Git LFS 的仓库，你需要在创建仓库后运行 git lfs install：
# initialize Git
$ mkdir Atlasteroids
$ cd Atlasteroids
$ git init
Initialized empty Git repository in /Users/tpettersen/Atlasteroids/.git/
# initialize Git LFS
$ git lfs
最低0.47元/天 解锁文章
扫一扫
2055
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
