Git LFS 在 Linux 系统上的安装指南

Git LFS 在 Linux 系统上的安装指南

git-lfs 项目地址: https://gitcode.com/gh_mirrors/git/git-lfs

Git LFS（Large File Storage）是 Git 的一个扩展，用于更好地管理大型文件。本文将详细介绍如何在 Linux 系统上通过包管理器安装 Git LFS。

安装前准备

在开始安装前，请确保：

1. 你拥有管理员权限（sudo）
2. 系统已安装 curl 工具
3. 网络连接正常

通过包管理器安装 Git LFS

第一步：添加软件仓库

Git LFS 官方提供了针对不同 Linux 发行版的软件仓库。我们需要先添加这些仓库到系统中。

对于基于 Debian/Ubuntu 的系统（使用 apt）

执行以下命令添加仓库：

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

对于基于 RHEL/CentOS 的系统（使用 yum）

执行以下命令添加仓库：

curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.rpm.sh | sudo bash

特殊情况处理

如果你的发行版是基于上游发行版的衍生版本（如 Linux Mint），可能需要指定上游发行版参数：

curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | os=debian dist=jessie sudo -E bash

对于 Ubuntu 衍生版本（如 Pop OS），可以使用以下命令自动检测：

(. /etc/lsb-release &&
curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh |
sudo env os=ubuntu dist="${DISTRIB_CODENAME}" bash)

第二步：安装 Git LFS

添加仓库后，就可以安装 Git LFS 了：

对于 Debian/Ubuntu 系统：

sudo apt-get update
sudo apt-get install git-lfs

对于 RHEL/CentOS 系统：

sudo yum install git-lfs

代理设置注意事项

如果你的系统需要通过代理访问互联网，需要注意 sudo 命令默认会重置环境变量。可以使用 -E 参数保留环境变量：

sudo -E bash -c 'curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | bash'

安装后验证

安装完成后，可以运行以下命令验证安装是否成功：

git lfs version

如果正确显示版本号，说明安装成功。

常见问题解决

1. 仓库添加失败：检查网络连接，确保能访问 packagecloud.io
2. 安装包找不到：确认你的发行版版本是否被支持
3. 权限问题：确保使用 sudo 执行命令

通过以上步骤，你应该已经成功在 Linux 系统上安装了 Git LFS。安装完成后，你可以在项目中使用 git lfs install 命令初始化 Git LFS，开始管理大型文件。

git-lfs 项目地址: https://gitcode.com/gh_mirrors/git/git-lfs