跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / Bash

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

介绍 Git LFS 在 Linux、macOS 和 Windows 系统上的安装方法，包括包管理器、源码编译及手动安装方案，并提供初始化配置、常见问题排查及基本使用示例。

城市逃兵发布于 2026/3/30更新于 2026/9/1281 浏览

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

前言：为什么需要 Git LFS？

在使用 Git 管理大型文件时，常遇到仓库体积膨胀、克隆耗时过长或 CI/CD 流程失败等问题。Git LFS（Git Large File Storage）通过将大文件存储在仓库之外，仅保留轻量级指针，有效解决上述痛点。本文提供 Git LFS 在 Linux、macOS 和 Windows 系统上的全平台安装指南。

一、Linux 系统安装指南

1.1 基于包管理器的快速安装

Debian/Ubuntu 系列

# 添加官方仓库
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

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
1.2 源码编译安装
# 安装编译依赖
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
1.3 离线安装方法

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

 rpm -ivh *.rpm
# 复制到目标机器后安装
sudo

二、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

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

安装方式LinuxmacOSWindows优势劣势
包管理器★★★★★★★★★☆★★★★☆自动更新、依赖管理版本可能不是最新
源码编译★★★★☆★★★★☆★★☆☆☆可定制、最新版本需安装编译工具
官方安装包★★★☆☆★★★★☆★★★★★简单直观需手动更新
第三方管理器★★☆☆☆★★★★★★★★★☆适合开发者环境需额外安装管理器

八、总结

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

目录

  1. Git LFS 跨平台安装指南：Linux、macOS 与 Windows
  2. 前言：为什么需要 Git LFS？
  3. 一、Linux 系统安装指南
  4. 1.1 基于包管理器的快速安装
  5. 添加官方仓库
  6. 安装 Git LFS
  7. 验证安装
  8. 添加官方仓库
  9. 安装 Git LFS
  10. 验证安装
  11. 1.2 源码编译安装
  12. 安装编译依赖
  13. 克隆仓库
  14. 编译并安装
  15. 验证安装
  16. 1.3 离线安装方法
  17. 复制到目标机器后安装
  18. 复制到目标机器后安装
  19. 二、macOS 系统安装指南
  20. 2.1 Homebrew 安装
  21. 安装 Git LFS
  22. 验证安装
  23. 2.2 MacPorts 安装
  24. 2.3 手动安装
  25. 下载最新稳定版二进制包
  26. 解压并安装
  27. 三、Windows 系统安装指南
  28. 3.1 Chocolatey 包管理器安装
  29. 3.2 官方安装程序
  30. 3.3 Scoop 包管理器安装
  31. 3.4 WSL 环境安装
  32. 四、安装后的初始化配置
  33. 全局启用 Git LFS
  34. 或仅对当前仓库启用
  35. 五、常见安装问题解决方案
  36. 5.1 "git: 'lfs' is not a git command" 错误
  37. 如未找到，手动添加安装路径到 PATH
  38. 5.2 仓库添加失败（Linux 权限问题）
  39. 5.3 macOS 安全提示
  40. 允许从任何来源安装（仅临时操作）
  41. 安装完成后恢复安全设置
  42. 5.4 Windows 命令提示符无法识别 git-lfs 命令
  43. 六、Git LFS 快速使用示例
  44. 跟踪大型文件类型
  45. 查看跟踪列表
  46. 添加跟踪配置到仓库
  47. 七、全平台安装方法对比表
  48. 八、总结

更多推荐文章

查看全部
  • 基于 MATLAB 的动态环境下多无人机系统协同路径规划与防撞
  • DOCX-MCP 开源项目：实现 AI 自动化操作 Word 文档
  • 使用 mise 统一配置 Java、Node 和 Python 开发环境
  • 使用 Anthropic Skill 提升大模型前端设计审美
  • 基于 YOLO11 的无人机航拍小目标检测实战
  • Android Framework 源码学习指南：系统启动、IPC 及核心组件解析
  • Linux 部署 NapCat QQ 机器人
  • Python 开发者如何结合心理洞察优化 AI 需求预测模型
  • 昇腾平台 DeepSeek-R1 与 Qwen2.5 强化学习训练优化实践
  • 基于 Java 和天地图 API 检索荣昌卤鹅店位置
  • 基于 Python 与 TensorFlow 的蔬菜图像识别系统设计与实现
  • WebMCP：Chrome 新 API 特性与 Agentic Web 前瞻
  • 飞算 JavaAI：Java 开发智能辅助工具深度体验
  • C++ STL 容器详解：map 与 set 核心用法与底层逻辑
  • 数据结构：图的基本概念与核心算法实现
  • PyCharm 安装与配置完整指南
  • Git 如何将特定提交合并到另一个分支？
  • 从零构建并训练 BERT 架构大模型实战指南
  • OpenClaw 消息路由机制详解
  • Qwen3-4B-Instruct-2507 智能写作助手部署与优化

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

  • Markdown转HTML

    将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online