Git LFS 用于管理 Git 仓库中的大文件，通过指针机制避免仓库膨胀。涵盖 Linux、macOS 及 Windows 系统的安装方法，包括包管理器、源码编译及图形界面安装。配置步骤包含全局启用命令 git lfs install 及 .gitattributes 跟踪设置。同时提供常见错误排查方案，如 PATH 环境变量未配置或权限问题，确保开发者能高效完成环境搭建与大文件版本控制。
在使用 Git 管理大型文件时，常遇到仓库体积膨胀、克隆耗时过长或 CI/CD 流程失败等问题。Git LFS（Git Large File Storage）通过将大型文件存储在仓库之外，仅在代码库中保留轻量级指针文件，有效解决上述痛点。
本文提供 Git LFS 全平台安装指南，涵盖 Linux、macOS 和 Windows 系统，包含源码编译、包管理器及手动安装方案，并提供环境配置技巧与常见错误排查。
# 添加 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 等衍生系统
# 添加 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 等兼容系统
# 安装编译依赖
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://github.com/git-lfs/git-lfs.git
cd git-lfs
# 编译并安装
make
sudo make install
# 验证安装
git lfs version
# 在有网络的机器上下载 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
# 在有网络的机器上下载 rpm 包
mkdir git-lfs-offline && cd git-lfs-offline
yum install --downloadonly --downloaddir=. git-lfs
# 复制到目标机器后安装
sudo rpm -ivh *.rpm
# 安装 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（如未安装）
# 从 https://www.macports.org/install.php 下载对应版本的安装包
# 安装 Git LFS
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
# 以管理员身份打开 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
git lfs version# 安装 Scoop
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex
# 安装 Git LFS
scoop install git-lfs
# 验证安装
git lfs version
在 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，确认配置成功
# 检查 Git LFS 是否在 PATH 中
which git-lfs # Linux/macOS
where git-lfs # Windows
# 如未找到，手动添加安装路径到 PATH
export PATH="$PATH:/usr/local/bin" # Linux/macOS，添加到~/.bashrc 或~/.zshrc
# 或在 Windows 系统环境变量中添加安装路径
# 非 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"
# 允许从任何来源安装（仅临时操作）
sudo spctl --master-disable
# 安装完成后恢复安全设置
sudo spctl --master-enable
Path，点击"编辑"C:\Program Files\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
| 安装方式 | Linux | macOS | Windows | 优势 | 劣势 |
|---|---|---|---|---|---|
| 包管理器 | ★★★★★ | ★★★★☆ | ★★★★☆ | 自动更新、依赖管理 | 版本可能不是最新 |
| 源码编译 | ★★★★☆ | ★★★★☆ | ★★☆☆☆ | 可定制、最新版本 | 需安装编译工具 |
| 官方安装包 | ★★★☆☆ | ★★★★☆ | ★★★★★ | 简单直观 | 需手动更新 |
| 第三方管理器 | ★★☆☆☆ | ★★★★★ | ★★★★☆ | 适合开发者环境 | 需额外安装管理器 |
通过本文已掌握 Git LFS 在三大操作系统上的安装方法，解决了大文件版本控制的首要障碍。建议继续学习：
.gitattributes 文件详解与模式匹配若遇到安装问题，可查阅官方文档或在项目 GitHub 仓库提交 issue 获取支持。
本文内容基于 Git LFS 最新稳定版（v3.5.1）编写，适用于主流操作系统版本。随着软件更新，部分命令可能需要调整，请以官方文档为准。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online