Git LFS 跨平台安装指南
在使用 Git 管理大型文件时，仓库体积膨胀和克隆耗时是常见问题。Git LFS（Git Large File Storage）通过将大文件存储在仓库之外，仅保留轻量级指针，有效解决了这些痛点。以下是在 Linux、macOS 和 Windows 上配置 Git LFS 的完整方案。
Linux 环境配置
包管理器快速安装
对于大多数发行版，直接使用系统包管理器是最稳妥的方式。
Debian/Ubuntu 系列
# 添加官方仓库
curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash
# 安装并验证
sudo apt-get install -y git-lfs
git lfs version
RHEL/CentOS/Fedora 系列
# 添加官方仓库
curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.rpm.sh | sudo bash
# 安装并验证
sudo yum install -y git-lfs
git lfs version
源码编译安装
如果需要最新版本或特定定制，可以从源码构建。
# 安装依赖
sudo apt-get install -y build-essential git golang-go asciidoctor
# 克隆并编译
git clone https://github.com/git-lfs/git-lfs.git
cd git-lfs
make
sudo make install
git lfs version
macOS 环境配置
Homebrew 安装（推荐）
# 确保已安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Git LFS
brew install git-lfs
git lfs version
手动安装
若需指定版本，可下载二进制包解压安装。
curl -OL https://github.com/git-lfs/git-lfs/releases/download/v3.5.1/git-lfs-darwin-amd64-v3.5.1.tar.gz
tar -zxvf git-lfs-darwin-amd64-v3.5.1.tar.gz
cd git-lfs-3.5.1
sudo ./install.sh
git lfs version
Windows 环境配置
Chocolatey 包管理器
适合习惯使用命令行管理的开发者。
# 设置执行策略
Set-ExecutionPolicy Bypass -Scope Process -Force
# 安装 Git LFS
choco install git-lfs -y
# 重启终端后验证
git lfs version
官方安装包
通过图形界面向导完成安装，适合不熟悉命令行的用户。
- 访问 GitHub Releases 页面下载
git-lfs-windows-amd64.exe。 - 双击运行并按提示操作。
- 打开命令提示符输入
git lfs version确认。
WSL 环境
在 Windows Subsystem for Linux 中，安装方法与 Linux 相同，推荐使用对应发行版的包管理器。
初始化与验证
无论采用何种方式，安装后必须全局启用 Git LFS 过滤器。
# 全局启用
git lfs install
# 或仅针对当前仓库
cd /path/to/repo
git lfs install --local
验证配置是否生效，检查过滤进程是否正常注册：
git config --global --get filter.lfs.process
正常应输出 git-lfs filter-process。
常见问题排查
命令未找到
如果提示 git: 'lfs' is not a git command，通常是因为环境变量 PATH 未包含 Git LFS 路径。
- Linux/macOS: 检查
which git-lfs，如未找到，将安装目录（如/usr/local/bin）添加到~/.bashrc或~/.zshrc的 PATH 中。 - Windows: 在系统环境变量中添加 Git LFS 安装路径（默认通常为
C:\Program Files\Git LFS），然后重启终端。
macOS 安全限制
遇到'无法打开因为无法验证开发者'提示时，可临时允许任意来源安装：
sudo spctl --master-disable
# 安装完成后建议恢复安全设置
sudo spctl --master-enable
实际使用示例
跟踪特定类型的大文件，例如设计稿或数据集。
# 定义跟踪规则
git lfs track "*.psd"
git lfs track "*.zip"
查看当前跟踪列表：
git lfs track
提交配置到仓库：
git add .gitattributes
git commit -m "Add LFS tracking rules"
后续推送大文件时，Git 会自动处理上传逻辑。
总结
Git LFS 是管理二进制资产和大型文件的必备工具。通过上述步骤，你可以在主流操作系统上完成部署。如果遇到版本更新导致的命令变更，建议查阅官方文档获取最新信息。
