1. Git LFS 简介
Git LFS（Large File Storage）是一个 Git 扩展，专门用于更高效地管理大型文件。它通过将大文件存储在远程服务器上，而只在 Git 仓库中保留指向这些文件的小型文本指针，从而避免仓库体积迅速膨胀。
Git 并不适合直接管理视频、大型数据集等大文件。因为 Git 会为每个文件的每个版本都保存一份副本，这会导致仓库体积急剧增长，影响克隆和拉取效率。
使用 Git LFS 后，像 data.csv 这样的大文件会被替换成一个小型指针文件。真正的文件内容则由 Git LFS 存储在远程服务器上。这样可以显著减小仓库体积，加快克隆和拉取速度。
1.1 示例
假设我们有一个 500MB 的数据文件 data.csv。如果我们不使用 Git LFS 直接提交这个文件，Git 会将其完整内容纳入版本控制，导致仓库体积剧增。
使用 Git LFS 后，当我们执行 git add data.csv 时，Git 实际上只提交了一个指向远程服务器上该文件的小型文本指针。真正的文件内容不会存储在仓库中，而是保留在远程服务器上。
1.2 Git LFS 常用命令概述
以下是几个关键的 Git LFS 命令及其作用：
- ✅
git lfs fetch：从远程仓库下载当前分支或提交的 LFS 文件到本地.git/lfs目录，但不会更新工作目录 - ✅
git lfs fetch --all：下载所有分支和提交中的 LFS 文件到.git/lfs，适用于全量备份 - ✅
git lfs checkout：将.git/lfs中已下载的文件更新到工作目录 - ✅
git lfs pull：等价于git lfs fetch+git lfs checkout，一次性完成拉取与更新
理解这些命令的区别，有助于我们更高效地管理 Git 仓库中的大型文件。
2. git lfs fetch 命令详解
git lfs fetch 用于从远程仓库下载当前分支或提交所关联的 LFS 文件，这些文件会被存放在 .git/lfs 目录中，但不会立即更新工作目录。
这个命令适合在我们想提前下载 LFS 文件但暂时不想影响当前工作目录时使用。
示例
假设我们当前在 main 分支：
$ git lfs fetch
该命令会下载 main 分支所需的 LFS 文件到 .git/lfs，但不会更新工作目录。
如果我们想同时下载多个分支的 LFS 文件，可以这样操作：
$ git lfs fetch origin main feature-branch bugfix-branch
这个命令会从 origin 远程仓库中下载 main、feature-branch 和 bugfix-branch 分支的 LFS 文件。
⚠️ 注意：这些文件只是被下载到 .git/lfs，并不会自动出现在工作目录中，需要配合 git lfs checkout 使用。
3. git lfs fetch --all 命令详解
git lfs fetch --all 是一个“全量”下载命令。它会下载远程仓库中所有分支、所有提交所涉及的所有 LFS 文件，并将其全部保存到 .git/lfs 目录中。
这个命令适用于以下场景：
- ✅ 需要完整备份仓库的 LFS 数据
- ✅ 迁移仓库时希望保留所有历史版本的大文件
示例
$ git lfs fetch --all
该命令会下载所有分支和提交中的 LFS 文件到 .git/lfs。
⚠️ 警告：这个命令会下载所有 LFS 文件，可能占用大量磁盘空间和网络带宽，尤其是在仓库包含大量大文件时。建议在有足够空间和带宽的情况下使用。
4. git lfs pull 命令详解
git lfs pull 是一个组合命令，它等价于：
$ git lfs fetch && git lfs checkout
也就是说，它不仅会下载当前分支所需的 LFS 文件，还会立即将这些文件更新到工作目录中。
示例
$ git lfs pull
执行后，LFS 文件会先被下载到 .git/lfs，然后被更新到工作目录，替换掉指针文件。
✅ 适用场景：当你克隆完仓库后，希望立即获取并使用所有 LFS 文件时。
5. 三者之间的区别总结
| 命令 | 下载范围 | 是否更新工作目录 | 适用场景 |
|---|---|---|---|
git lfs fetch |
当前分支或指定分支 | ❌ 否 | 提前下载 LFS 文件，但不更新工作目录 |
git lfs fetch --all |
所有分支、所有提交 | ❌ 否 | 完整备份或迁移仓库 |
git lfs pull |
当前分支 | ✅ 是 | 拉取并立即使用 LFS 文件 |
使用建议
- ✅ 切换分支后想提前下载该分支的 LFS 文件？使用
git lfs fetch - ✅ 需要做全量备份或迁移？使用
git lfs fetch --all - ✅ 克隆完仓库后想立即使用所有 LFS 文件？使用
git lfs pull
6. 总结
本文详细介绍了 git lfs fetch、git lfs fetch --all 和 git lfs pull 三个命令的区别和使用场景。
简单来说：
- ✅
git lfs fetch：下载 LFS 文件但不更新工作目录 - ✅
git lfs fetch --all：下载所有分支的 LFS 文件，适合备份和迁移 - ✅
git lfs pull：下载并更新工作目录，适合新环境初始化
理解这些命令的行为，能帮助我们更高效地管理 Git 仓库中的大文件，避免不必要的网络请求和磁盘占用。
如果你在使用 Git LFS 的过程中遇到文件缺失、下载慢等问题，记得检查是否使用了正确的命令，以及是否执行了 checkout 步骤。这些小细节很容易被忽视，但往往就是问题的根源所在。⚠️