Git LFS 安装教程：Linux、macOS 与 Windows 全平台指南

Debian/Ubuntu 离线安装包准备

# 在有网络的机器上下载 deb 包
mkdir git-lfs-offline && cd git-lfs-offline
apt-get download git-lfs
$(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances git-lfs | grep "^\w" | sort -u)
# 复制到目标机器后安装
sudo dpkg -i *.deb

RHEL/CentOS 离线安装包准备

# 在有网络的机器上下载 rpm 包
mkdir git-lfs-offline && cd git-lfs-offline
yum install --downloadonly --downloaddir=. git-lfs
# 复制到目标机器后安装
sudo rpm -ivh *.rpm

二、macOS 系统安装指南

2.1 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

2.2 MacPorts 安装

# 安装 MacPorts（如未安装）
# 从 https://www.macports.org/install.php 下载对应版本的安装包
# 安装 Git LFS
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 包管理器安装（推荐）

# 以管理员身份打开 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'))
# 安装 Git LFS
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 包管理器安装（开发者首选）

# 安装 Scoop
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex
# 安装 Git LFS
scoop install git-lfs
# 验证安装
git lfs version

3.4 WSL 环境安装

在 Windows Subsystem for Linux 中安装方法与 Linux 系统完全相同，推荐使用对应发行版的包管理器：

# Ubuntu/WSL 示例
sudo apt-get update
sudo apt-get install -y git-lfs
git lfs version

四、安装后的初始化配置

无论使用哪种安装方式，完成后都需要执行以下命令启用 Git LFS：

# 全局启用 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" 错误

# 检查 Git LFS 是否在 PATH 中
which git-lfs # Linux/macOS
where git-lfs # Windows

# 如未找到，手动添加安装路径到 PATH
export PATH="$PATH:/usr/local/bin" # Linux/macOS，添加到~/.bashrc 或~/.zshrc
# 或在 Windows 系统环境变量中添加安装路径

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

# 非 root 用户安装时指定本地路径
curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash
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" # Photoshop 文件
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 在三大操作系统上的安装方法，解决了大文件版本控制的首要障碍。建议继续学习：

1. Git LFS 高级配置：.gitattributes 文件详解与模式匹配
2. 大文件迁移策略：已有仓库的历史大文件处理方案
3. 性能优化技巧：缓存配置与并行传输设置

若遇到安装问题，可查阅官方文档或在项目 GitHub 仓库提交 issue 获取支持。

本文内容基于 Git LFS 最新稳定版（v3.5.1）编写，适用于主流操作系统版本。随着软件更新，部分命令可能需要调整，请以官方文档为准。