Git LFS 跨平台安装指南：Linux、macOS 与 Windows

二、macOS 系统安装指南

2.1 Homebrew 安装

# 安装 Git LFS
brew install git-lfs
# 验证安装
git lfs version

2.2 MacPorts 安装

sudo port install git-lfs
git lfs version

2.3 手动安装

# 下载最新稳定版二进制包
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 系统安装指南

3.1 Chocolatey 包管理器安装

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 version

3.2 官方安装程序

1. 下载最新 Windows 安装包：git-lfs-windows-amd64.exe
2. 双击运行安装程序，按照向导完成安装
3. 打开命令提示符验证：git lfs version

3.3 Scoop 包管理器安装

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

3.4 WSL 环境安装

在 Windows Subsystem for Linux 中安装方法与 Linux 系统相同。

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

四、安装后的初始化配置

# 全局启用 Git LFS
git lfs install
# 或仅对当前仓库启用
cd /path/to/your/repo
git lfs install --local

配置检查：通过 git config --global --get filter.lfs.process 验证是否输出 git-lfs filter-process。

五、常见安装问题解决方案

5.1 "git: 'lfs' is not a git command" 错误

which git-lfs
# 如未找到，手动添加安装路径到 PATH
export PATH="$PATH:/usr/local/bin"

5.2 仓库添加失败（Linux 权限问题）

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

5.3 macOS 安全提示

# 允许从任何来源安装（仅临时操作）
sudo spctl --master-disable
# 安装完成后恢复安全设置
sudo spctl --master-enable

5.4 Windows 命令提示符无法识别 git-lfs 命令

1. 打开'控制面板 > 系统 > 高级系统设置 > 环境变量'
2. 在系统变量中找到 Path，点击'编辑'
3. 添加 Git LFS 安装路径（默认是 C:\Program Files\Git LFS）
4. 重启命令提示符

六、Git LFS 快速使用示例

# 跟踪大型文件类型
git lfs track "*.psd"
git lfs track "*.zip"
git lfs track "*.iso"
# 查看跟踪列表
git lfs track
# 添加跟踪配置到仓库
git add .gitattributes
git add large-file.psd
git commit -m "Add design assets"
git push origin main

七、全平台安装方法对比表

八、总结

通过本文已掌握 Git LFS 在三大操作系统上的安装方法。建议继续学习 .gitattributes 文件详解与大文件迁移策略。若遇问题，可查阅官方文档或在项目 GitHub 仓库提交 issue 获取支持。