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

装好Git LFS:Linux、macOS、Windows三平台记录

记录在 Linux、macOS 和 Windows 上安装 Git LFS 的多种方式,包括包管理器、源码编译、手动二进制安装以及图形界面。涵盖初始化、PATH 配置、macOS 安全限制等常见问题,并给出跟踪大文件的实际操作示例。

战神发布于 2026/6/24更新于 2026/9/1034 浏览

装 Git LFS 这事,每个平台折腾一遍就清楚了。下面是我在 Linux、macOS 和 Windows 上的安装记录,顺便提了几种常见坑的处理。

Linux 环境

多数发行版用自带包管理器就够了。如果是 Debian/Ubuntu,跑这两行:

curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash
sudo apt-get install -y git-lfs
git lfs version

RHEL/CentOS/Fedora 把脚本换成 rpm 源:

curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.rpm.sh | sudo bash
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

macOS 环境

用 Homebrew 最省事,前提是机器上装了 brew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew 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

Windows 环境

习惯命令行就用 Chocolatey,先调整执行策略再装:

Set-ExecutionPolicy Bypass -Scope Process -Force
choco install git-lfs -y

关掉终端再打开,git lfs version 验证一下。

如果偏好图形界面,直接去 GitHub Releases 页面下载 git-lfs-windows-amd64.exe,双击一路下一步,然后开命令提示符确认安装。

在 WSL 里,安装方式和 Linux 完全一样,照着前面发行版的步骤来就行。

初始化与验证

装完必须启用 LFS 过滤器,否则白装了:

git lfs install

也可以只针对某个仓库启用 git lfs install --local。用下面命令检查是否生效:

git config --global --get filter.lfs.process

正常会输出 git-lfs filter-process。

常见问题

命令未找到:执行 git lfs 提示不是 git 命令,八成是 PATH 没配上。先 which git-lfs 看有没有,没有就把安装目录(如 /usr/local/bin)加到 .bashrc 或 .zshrc 里。Windows 上要在系统环境变量里加上 C:\Program Files\Git LFS,然后重启终端。

macOS 安全限制:遇到'无法打开因为无法验证开发者',临时放宽一下:

sudo spctl --master-disable
# 安装完马上恢复
sudo spctl --master-enable

实际使用

举个例子,我需要跟踪 psd 和 zip 文件:

git lfs track "*.psd"
git lfs track "*.zip"

git lfs track 可以查看当前跟踪规则。最后别忘了提交 .gitattributes:

git add .gitattributes
git commit -m "Add LFS tracking rules"

之后 push 大文件,Git LFS 自动接管,不用额外操心。

目录

  1. Linux 环境
  2. macOS 环境
  3. Windows 环境
  4. 初始化与验证
  5. 常见问题
  6. 安装完马上恢复
  7. 实际使用

更多推荐文章

查看全部
  • 医疗连续体机器人模块化控制界面设计与 Python 库应用
  • Science Robotics 新突破:注意力机制结合强化学习实现足式机器人障碍穿越
  • GitHub Copilot 学生认证与使用指南
  • Redis 与分布式架构入门:从单机到微服务的演进之路
  • 前端首屏加载优化方案
  • 多模态 Agent 图像识别技能开发:JavaScript+Python 全栈图像处理方案
  • OpenClaw:开源自托管 AI Agent 框架技术解析
  • C++ STL list 容器详解:使用与模拟实现
  • 使用 CopilotKit 快速为前端集成 AI 助手实战指南
  • 基于 STM32 的智能家居环境监测与控制系统设计
  • 前端如何编写优秀的 AI Agent Skills
  • Python接单指南
  • AI 与存储的结合:智能存储的实践与挑战
  • vphone-cli:在 macOS 上虚拟运行 iOS 系统的强大工具
  • OpenClaw 本地推理方案:基于 Ollama 部署开源模型降低 Token 成本
  • 基于 AKSHARE 与 AI 的金融数据分析实践
  • Antigravity 集成 Figma MCP 实现像素级还原 AI 编程
  • GitHub MCP Server 集成 AI 工具工作流指南
  • Linux 部署本地 AI 大模型与知识库集成指南
  • Mac 下使用 Docker 部署 FastGPT 构建 AI 私有知识库

相关免费在线工具

  • 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