Git LFS 跨平台安装指南：Linux/macOS/Windows 配置实战

# 安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Git LFS
brew install git-lfs
# 验证
git lfs version

MacPorts 安装

# 从官网下载安装包后执行
sudo port 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 包管理器

以管理员身份运行 PowerShell。

Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
choco install git-lfs -y

安装完成后需重新打开命令提示符才能识别 git lfs 命令。

官方安装程序

1. 访问 GitHub Release 页面下载 git-lfs-windows-amd64.exe。
2. 双击运行，按向导完成安装。
3. 重启终端验证：git lfs version。

Scoop 包管理器

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex
scoop install git-lfs
git lfs version

WSL 环境

在 WSL 中安装方法与 Linux 相同，推荐使用对应发行版的包管理器。

sudo apt-get update
sudo apt-get install -y git-lfs
git lfs version

初始化配置

安装完成后，必须启用 Git LFS 过滤器。

# 全局启用（对所有仓库生效）
git lfs install
# 或仅对当前仓库启用
cd /path/to/repo
git lfs install --local

检查配置：执行 git config --global --get filter.lfs.process，若输出 git-lfs filter-process 则配置成功。

常见问题排查

1. 找不到命令

错误提示：git: 'lfs' is not a git command

检查 PATH 环境变量是否包含 Git LFS 安装目录。

which git-lfs

Linux/macOS 可添加到 ~/.bashrc 或 ~/.zshrc：

export PATH="$PATH:/usr/local/bin"

Windows 需在系统环境变量中添加 C:\Program Files\Git LFS。

2. 权限问题

非 root 用户安装时，建议指定本地路径。

sudo apt-get install -y git-lfs --prefix=$HOME/.local
export PATH="$HOME/.local/bin:$PATH"

3. macOS 安全提示

若提示'无法打开因为无法验证开发者'，可临时允许安装。

sudo spctl --master-disable
# 安装完成后恢复
sudo spctl --master-enable

基础使用示例

跟踪特定类型的大文件。

# 设置跟踪规则
git lfs track "*.psd"
git lfs track "*.zip"
# 提交配置到仓库
git add .gitattributes
# 正常提交大文件
git add large-file.psd
git commit -m "Add design assets"
git push origin main

通过上述步骤，即可完成 Git LFS 的全平台部署。后续可根据项目需求调整 .gitattributes 中的匹配模式，优化缓存与传输策略。