Git LFS 大文件管理指南

Tue, 15 Jul 2025 10:29:29 +0800

Git LFS 完全指南：轻松管理 Git 仓库中的大文件

在日常开发中，你是否遇到过这样的问题：Git 仓库因为几张设计图、一个安装包而体积暴增，克隆代码需要几十分钟，git status 命令卡顿严重？如果你正在被大文件拖累 Git 仓库性能，那么 Git LFS 就是你的救星。

什么是 Git LFS？

Git LFS（Large File Storage，大文件存储）是 Git 的一个扩展工具，专门为解决 Git 对大文件支持不足的问题而设计。它的核心思路是：用轻量的「指针文件」替代实际大文件存储在 Git 仓库中，而真正的大文件则单独存储在 LFS 服务器，从而避免 Git 仓库体积膨胀，提升操作效率。

为什么需要 Git LFS？

Git 本身的设计更适合管理文本文件（如代码、配置文件），因为文本文件体积小，且 Git 能通过「差异对比」（只记录修改部分）高效存储版本历史。但面对图片、视频、安装包等大文件时，Git 会暴露明显缺陷：

仓库体积爆炸：Git 会完整保存大文件的每一个版本，几次修改后仓库可能从 MB 级膨胀到 GB 级，克隆/拉取速度极慢。
操作卡顿：git status、git commit 等命令需要扫描文件，大文件会显著拖慢这些操作。
存储浪费：重复存储大文件的多个版本，占用大量本地和远程存储空间。

而 Git LFS 正是为解决这些问题而生——它让 Git 既能管理大文件的版本，又不用承受大文件带来的性能负担。

Git LFS 工作原理

Git LFS 的核心是「分离存储」，简单来说分为三步：

用指针替代大文件
当你用 LFS 跟踪大文件时，Git 不会把实际文件存入仓库，而是生成一个几百字节的「指针文件」（包含大文件的唯一哈希和大小），指针文件会被正常提交到 Git 仓库。
大文件单独存储
实际的大文件会被上传到 LFS 服务器（如 GitHub、GitLab 的 LFS 服务），并通过哈希值与指针文件关联。
按需下载大文件
其他人克隆仓库时，先下载轻量的指针文件，再通过 LFS 工具自动从服务器下载对应的实际大文件（仅在需要时下载）。

Git LFS 安装与初始化

1. 安装 Git LFS

Windows：从 Git LFS 官网下载安装包，或通过包管理器：
1

choco install git-lfs # Chocolatey
macOS：使用 Homebrew：
1

brew install git-lfs

Linux：通过系统包管理器：

1
2
3
4


# Debian/Ubuntu
sudo apt-get install git-lfs
# CentOS/RHEL
sudo yum install git-lfs

2. 初始化 Git LFS

安装后，需要在仓库中初始化 LFS（每个仓库只需执行一次）：

`1`	`git lfs install`

执行成功后，会看到类似输出：
Git LFS initialized.

Git LFS 核心操作指南

1. 跟踪大文件

Git LFS 不会自动识别大文件，需要手动配置「跟踪规则」（通过文件类型或路径匹配）。

跟踪特定类型的文件（如所有 .zip 压缩包）：
1

git lfs track "*.zip"
跟踪指定目录下的文件（如 assets/ 目录下的所有 .png 图片）：
1

git lfs track "assets/*.png"
跟踪单个特定文件（如 installer.exe）：
1

git lfs track "installer.exe"

执行上述命令后，仓库会生成/更新 .gitattributes 文件，其中记录了 LFS 跟踪规则（需提交到仓库，确保团队成员同步配置）。

2. 查看跟踪规则

检查当前 LFS 跟踪的文件类型：

`1`	`git lfs track`

示例输出：

1
2
3


assets/*.png (.gitattributes)
*.zip (.gitattributes)
installer.exe (.gitattributes)

3. 取消跟踪文件

如果需要取消对某类文件的跟踪（仅移除规则，不影响历史提交）：

1

git lfs untrack "*.zip"

4. 正常提交与推送

配置跟踪规则后，日常操作与普通 Git 完全一致：

1
2
3
4
5
6


# 添加文件（LFS 会自动处理跟踪的大文件）
git add 大文件.zip
# 提交
git commit -m "添加大文件"
# 推送（LFS 会自动上传实际大文件到 LFS 服务器）
git push

5. 拉取 LFS 跟踪的文件

克隆仓库后，指针文件会被正常下载，但实际大文件需要手动拉取：

1
2
3
4
5


# 克隆仓库
git clone <仓库地址>
cd <仓库目录>
# 拉取 LFS 跟踪的实际文件
git lfs pull

如果希望克隆时自动拉取 LFS 文件，可以直接使用：

`1`	`git lfs clone <仓库地址>`

6. 查看 LFS 跟踪的文件列表

检查当前仓库中被 LFS 跟踪的文件：

`1`	`git lfs ls-files`

示例输出（哈希值为文件唯一标识）：

1
2


abc12345 * 大文件.zip
def67890 * assets/image.png

常见问题与解决方案

1. 拉取后大文件变成 100-200B 的小文件？

这是因为拉取的是 LFS 指针文件（而非实际文件），执行 git lfs pull 即可下载实际内容。

2. 推送时提示 LFS 文件未上传？

可能是本地 LFS 未初始化，或推送时网络问题。解决方案：

1
2
3
4


# 重新初始化 LFS
git lfs install
# 手动上传 LFS 文件
git lfs push --all origin main

3. 如何迁移已存在的大文件到 LFS？

如果仓库历史中已有大文件，可以用 git lfs migrate 命令迁移（谨慎操作，会改写历史）：

1
2


# 将所有 .zip 文件迁移到 LFS（针对 master 分支）
git lfs migrate import --include="*.zip" --everything

总结

Git LFS 是管理大文件的利器，它通过「指针-实际文件分离存储」的设计，解决了 Git 仓库因大文件导致的体积膨胀、操作卡顿等问题。只需简单配置跟踪规则，就能在不改变原有 Git 工作流的前提下，高效管理图片、视频、安装包等大文件。

如果你经常在项目中处理大文件，不妨尝试 Git LFS——让你的 Git 仓库保持轻盈，操作如丝般顺滑。

Git-Lfs on DK Blog