WSL-Ubuntu 中安装 Git LFS 记录

#记录工作

一、问题背景

在 Windows Subsystem for Linux（WSL）的 Ubuntu 环境下进行开发时，当我们需要管理 Git 仓库中的大文件，使用 Git LFS（Large File Storage）是一个很好的解决方案。但在执行git lfs install命令时，可能会遇到fatal: 'lfs' appears to be a git command, but we were not able to execute it. Maybe git-lfs is broken?等错误，本文将详细记录解决这些问题并成功安装 Git LFS 的方法。

(base) love@AI:~$ git lfs install

fatal: 'lfs' appears to be a git command, but we were not able to execute it. Maybe git-lfs is broken?

二、安装步骤

1. 安装依赖

在 WSL-Ubuntu 的终端中，依次执行以下命令安装必要的依赖项：

sudo apt update
sudo apt install -y curl gnupg2 software-properties-common

apt update命令用于更新软件包列表，sudo apt install用于安装curl、gnupg2和software-properties-common，这些工具在后续添加软件源和安装过程中会用到。

2. 添加 Git LFS 官方仓库

运行以下命令添加 Git LFS 官方仓库：

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

此命令会自动将 Git LFS 的软件源添加到 WSL-Ubuntu 系统中，以便后续安装。

3. 安装 Git LFS

添加完仓库后，执行以下命令安装 Git LFS：

sudo apt install -y git-lfs

安装过程中，WSL-Ubuntu 系统会自动下载并安装 Git LFS 及其相关依赖。

4. 初始化 Git LFS

安装完成后，通过以下命令初始化 Git LFS：

git lfs install

执行成功后，会显示Git LFS initialized.，此时 Git LFS 就可以在 WSL-Ubuntu 环境中正常使用了。我们可以使用git lfs version命令查看 Git LFS 的版本信息，验证安装是否成功。

git lfs version

三、常见问题及解决方法

1. 依赖问题

在 WSL-Ubuntu 中执行依赖安装命令或 Git LFS 安装命令时，可能会遇到软件包依赖不满足的情况，例如执行sudo apt install -y curl gnupg2 software-properties-common时提示：

You might want to run 'apt --fix-broken install' to correct these.
The following packages have unmet dependencies:...
E: Unmet dependencies. Try 'apt --fix-broken install' with no packages (or specify a solution).

此时，可以使用以下命令修复损坏的依赖关系：

sudo apt --fix-broken install

修复完成后，再重新执行依赖安装和 Git LFS 安装步骤。 

2. 安装后仍无法执行

如果在 WSL-Ubuntu 中安装完成后，执行git lfs install仍然报错，可以尝试以下方法：

• 手动初始化：使用命令$(which git-lfs) install指定完整路径执行初始化。
• 检查文件权限：确保 Git LFS 可执行文件具有执行权限，执行sudo chmod +x /usr/bin/git-lfs。
• 检查动态链接库依赖：通过ldd /usr/bin/git-lfs命令检查动态链接库依赖是否完整，确保没有not found的依赖项。
• 清理并重新安装：先使用sudo apt purge git-lfs和sudo apt autoremove命令彻底删除 Git LFS 及其相关依赖，然后重新按照上述安装步骤进行安装。

四、验证与使用

成功在 WSL-Ubuntu 中安装并初始化 Git LFS 后，可以在 Git 仓库中使用 Git LFS 管理大文件。例如，在仓库中启用 LFS 管理特定类型文件：

# 在仓库中启用 LFS（首次使用时）
git lfs install
# 指定要跟踪的文件类型
git lfs track "*.psd"  # 跟踪所有 PSD 文件
git lfs track "*.mp4"  # 跟踪视频文件
# 提交配置文件
git add.gitattributes
git commit -m "Add LFS file tracking"
# 正常提交文件
git add large_file.mp4
git commit -m "Add large file"
git push

 

这样，大文件就会被 Git LFS 进行特殊管理，而不是直接存储在 Git 仓库中，从而避免仓库过大的问题。

通过以上步骤，我们可以在 WSL-Ubuntu 环境中成功安装并使用 Git LFS，方便地管理项目中的大文件。如果在安装过程中遇到其他问题，欢迎在评论区交流讨论。