新手使用 Git LFS 快速上手
一 概念与适用场景
先来聊聊 Git LFS 到底是什么。简单来说，它是 Git 的一个扩展，专门用来解决大文件带来的“仓库膨胀”问题。它的核心思路很巧妙：用一个小小的“指针”文件，替换掉仓库里真正的大文件。而大文件的真实内容，则被存放在专门的 LFS 存储服务器上。
这样一来，当你克隆或拉取仓库时，首先拿到的是轻量的指针，只有在真正需要的时候（比如检出文件），才会自动下载大文件内容。整个过程对开发者几乎是透明的，但效果立竿见影——仓库体积变小了，日常操作变快了。
那么，哪些文件适合交给 LFS 来管理呢？通常包括：设计源文件（如 PSD、AI）、音视频文件、压缩包、数据集、安装包以及 AI 模型文件等体积较大的二进制资源。它的工作原理可以概括为三步：当你添加（add）文件时，Git LFS 会拦截并写入指针；推送（push）时，真实内容会上传到 LFS 服务器；而在检出（checkout）时，过滤器会自动将指针还原成真实的文件。
二 安装与初始化
安装
- Windows：最省心的方式是安装最新版的 Git for Windows，它已经集成了 LFS。当然，你也可以去官网单独下载安装包。安装完成后，记得在命令行里执行一次初始化命令。
- macOS：如果你在用 Homebrew，一条命令就能搞定：
brew install git-lfs。 - Linux (Debian/Ubuntu)：可以通过以下命令安装：
curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash sudo apt-get install git-lfs - Linux (RHEL/CentOS)：
curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.rpm.sh | sudo bash sudo yum install git-lfs # 或者使用 dnf # dnf install git-lfs - 二进制包/源码：你也可以从 GitHub Releases 页面获取安装包或源码，运行安装脚本后，它会自动配置 PATH 并执行必要的初始化。
初始化
安装完成后，全局启用一次即可：git lfs install。这个命令会为当前用户设置好 Git 钩子和过滤器，让 LFS 开始生效。
三 新仓库使用步骤
在一个全新的仓库里启用 Git LFS，跟着下面几步走就行：
- 创建并进入仓库
git init git remote add origin - 配置跟踪规则（这些规则会被写入 .gitattributes 文件）
# 跟踪特定类型的文件 git lfs track "*.psd" git lfs track "*.zip" "*.mp4" # 谨慎使用：按文件大小跟踪（例如大于100MB的文件） git lfs track --size=100M "*" # 查看当前已配置的所有规则 git lfs track - 提交并推送
git add .gitattributes git add large_file.psd git commit -m "Add large file with LFS" git push origin main - 克隆与拉取
- 常规克隆：如果本地已安装 LFS，克隆时会自动下载大文件内容：
git clone。 - 手动拉取：如果克隆后发现大文件显示为指针文本，可以运行
git lfs pull手动拉取真实内容。
- 常规克隆：如果本地已安装 LFS，克隆时会自动下载大文件内容：
- 常用检查命令
# 查看所有被 LFS 跟踪的文件 git lfs ls-files # 查看 LFS 文件的状态 git lfs status - 可选：文件锁定（避免多人同时修改同一个二进制文件）
# 锁定文件 git lfs lock images/logo.png # 列出所有被锁定的文件 git lfs locks # 解锁文件 git lfs unlock images/logo.png
以上流程在 GitHub、GitLab、Codeup 等主流代码托管平台上都是通用的。
四 常见问题与避坑
最后，分享几个实践中容易踩坑的地方，帮你绕开弯路：
- 确保远程仓库支持 LFS：虽然 GitHub、GitLab、Codeup 等主流平台都支持，但部分场景（如自建 GitLab）可能需要先在项目或平台侧手动开启。如果没启用，推送时可能会失败，或者只上传了指针。
- 不要“事后”补救：千万不要对已经提交到 Git 历史里的大文件“事后”添加 LFS 跟踪。因为历史版本仍然会占用仓库体积。正确的做法是先备份，然后使用
git lfs migrate import --include="*.psd,*.mp4"这样的命令来迁移历史记录，最后强制推送（git push --force）。注意，这是个高风险操作，务必先备份并经过团队评审。 - 务必提交 .gitattributes 文件：这个文件是团队共享 LFS 规则的依据。如果不提交，其他成员的本地环境就无法正确识别和处理 LFS 文件。
- 关注配额与成本：大多数平台对 LFS 存储和带宽都有限制或单独计费。记得定期清理无用的旧版本，必要时考虑升级套餐。
- 性能提示：LFS 能显著改善克隆和拉取速度，但对于频繁修改的大文件，性能影响依然存在。对于超大的数据集，尽量考虑拆分成小块，或者采用外部化存储管理。
- 注意大小写与通配符：在配置跟踪规则时，比如
git lfs track "*.psd"，建议使用双引号，避免 Shell 自动扩展导致匹配错误。同时，确保路径模式与实际文件位置相匹配。
