介绍 Git LFS 在 Linux、macOS 和 Windows 系统上的安装方法，包括包管理器、源码编译及手动安装方案，并提供初始化配置、常见问题排查及基本使用示例。
在使用 Git 管理大型文件时，常遇到仓库体积膨胀、克隆耗时过长或 CI/CD 流程失败等问题。Git LFS（Git Large File Storage）通过将大文件存储在仓库之外，仅保留轻量级指针，有效解决上述痛点。本文提供 Git LFS 在 Linux、macOS 和 Windows 系统上的全平台安装指南。
Debian/Ubuntu 系列
# 添加官方仓库
curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | bash
apt-get install -y git-lfs
git lfs version
RHEL/CentOS 系列
# 添加官方仓库
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
# 安装编译依赖
sudo apt-get install -y build-essential git golang-go asciidoctor
# 克隆仓库
git clone https://github.com/git-lfs/git-lfs.git
cd git-lfs
# 编译并安装
make
sudo make install
# 验证安装
git lfs version
Debian/Ubuntu 离线安装包准备
mkdir git-lfs-offline && cd git-lfs-offline
apt-get download git-lfs
# 复制到目标机器后安装
sudo dpkg -i *.deb
RHEL/CentOS 离线安装包准备
mkdir git-lfs-offline && cd git-lfs-offline
yum install --downloadonly --downloaddir=. git-lfs
# 复制到目标机器后安装
sudo rpm -ivh *.rpm
# 安装 Git LFS
brew install git-lfs
# 验证安装
git lfs version
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
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
git lfs versionSet-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex
scoop install git-lfs
git lfs version
在 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。
which git-lfs
# 如未找到，手动添加安装路径到 PATH
export PATH="$PATH:/usr/local/bin"
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"
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 获取支持。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 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