2025最新Git LFS安装教程：Linux/macOS/Windows全平台覆盖
【免费下载链接】git-lfs Git extension for versioning large files 项目地址: https://gitcode.com/gh_mirrors/gi/git-lfs
前言：为什么需要Git LFS？
你是否在使用Git管理大型文件时遇到过以下问题？仓库体积膨胀到GB级别、克隆项目耗时超过30分钟、CI/CD流程频繁失败？Git LFS（Git Large File Storage，Git大文件存储）通过将大型文件（如设计稿、数据集、二进制资产）存储在Git仓库之外，仅在代码库中保留轻量级指针文件，完美解决了这些痛点。本文将提供2025年最新的Git LFS全平台安装指南，涵盖Linux、macOS和Windows系统，让你5分钟内完成配置，告别大文件管理难题。
读完本文你将学到：
3大操作系统的Git LFS安装方法源码编译/包管理器/手动安装3种部署方案安装后的验证与环境配置技巧常见错误的排查与解决方案
一、Linux系统安装指南（Ubuntu/Debian/CentOS/Fedora）
1.1 基于包管理器的快速安装（推荐）
Debian/Ubuntu系列（apt/deb）
# 添加Git LFS官方仓库
curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash
# 安装Git LFS
sudo apt-get install -y git-lfs
# 验证安装
git lfs version
支持的发行版本：Debian 10+/Ubuntu 18.04+，包括Linux Mint、Pop!_OS等衍生系统
RHEL/CentOS系列（yum/rpm）
# 添加Git LFS官方仓库
curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.rpm.sh | sudo bash
# 安装Git LFS
sudo yum install -y git-lfs
# 验证安装
git lfs version
支持的发行版本：CentOS 7+/RHEL 7+/Fedora 30+，包括Oracle Linux、Rocky Linux等兼容系统
1.2 源码编译安装（适合最新版本体验）
# 安装编译依赖
sudo apt-get install -y build-essential git golang-go asciidoctor # Debian/Ubuntu
# 或
sudo yum install -y gcc git golang asciidoctor # CentOS/RHEL
# 克隆仓库
git clone https://gitcode.com/gh_mirrors/gi/git-lfs.git
cd git-lfs
# 编译并安装
make
sudo make install
# 验证安装
git lfs version
1.3 离线安装方法（适用于无网络环境）
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 官方安装程序（图形界面）
下载最新Windows安装包：git-lfs-windows-amd64.exe双击运行安装程序，按照向导完成安装安装完成后，打开命令提示符验证：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命令
打开"控制面板 > 系统 > 高级系统设置 > 环境变量"在系统变量中找到Path，点击"编辑"添加Git LFS安装路径（默认是C:\Program Files\Git LFS）重启命令提示符
六、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
七、全平台安装方法对比表
安装方式LinuxmacOSWindows优势劣势包管理器★★★★★★★★★☆★★★★☆自动更新、依赖管理版本可能不是最新源码编译★★★★☆★★★★☆★★☆☆☆可定制、最新版本需安装编译工具官方安装包★★★☆☆★★★★☆★★★★★简单直观需手动更新第三方管理器★★☆☆☆★★★★★★★★★☆适合开发者环境需额外安装管理器
八、总结与后续学习
通过本文你已掌握Git LFS在三大操作系统上的安装方法，解决了大文件版本控制的首要障碍。建议继续学习：
Git LFS高级配置：.gitattributes文件详解与模式匹配大文件迁移策略：已有仓库的历史大文件处理方案性能优化技巧：缓存配置与并行传输设置
若遇到安装问题，可查阅官方文档或在项目GitHub仓库提交issue获取支持。
本文内容基于Git LFS最新稳定版（v3.5.1）编写，适用于2025年主流操作系统版本。随着软件更新，部分命令可能需要调整，请以官方文档为准。
【免费下载链接】git-lfs Git extension for versioning large files 项目地址: https://gitcode.com/gh_mirrors/gi/git-lfs