新手如何用LFS

新手使用 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，跟着下面几步走就行：

1. 创建并进入仓库

   git init
   git remote add origin 

2. 配置跟踪规则（这些规则会被写入 .gitattributes 文件）

   # 跟踪特定类型的文件
   git lfs track "*.psd"
   git lfs track "*.zip" "*.mp4"
   
   # 谨慎使用：按文件大小跟踪（例如大于100MB的文件）
   git lfs track --size=100M "*"
   
   # 查看当前已配置的所有规则
   git lfs track

3. 提交并推送

   git add .gitattributes
   git add large_file.psd
   git commit -m "Add large file with LFS"
   git push origin main

4. 克隆与拉取
   • 常规克隆：如果本地已安装 LFS，克隆时会自动下载大文件内容：git clone 。
   • 手动拉取：如果克隆后发现大文件显示为指针文本，可以运行 git lfs pull 手动拉取真实内容。
5. 常用检查命令

   # 查看所有被 LFS 跟踪的文件
   git lfs ls-files
   
   # 查看 LFS 文件的状态
   git lfs status

6. 可选：文件锁定（避免多人同时修改同一个二进制文件）

   # 锁定文件
   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 自动扩展导致匹配错误。同时，确保路径模式与实际文件位置相匹配。