git-lfs: command not found

天若子2025-03-26 13:36

遇到 git-lfs: command not found 错误，表示你的系统中未安装 Git Large File Storage (LFS) 扩展工具。以下是针对不同操作系统的解决方案：

1. 安装 Git LFS

根据你的操作系统选择安装方式：

macOS

使用 Homebrew（推荐）：
复制代码
```
brew install git-lfs
```
手动安装：
1. 下载安装包：Git LFS 官网
2. 解压并运行安装脚本：
  复制代码
```
tar -xf git-lfs-*.tar.gz
cd git-lfs-*
sudo ./install.sh
```

Linux (Debian/Ubuntu)

APT 安装：

复制代码

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

手动安装：

复制代码

wget https://github.com/git-lfs/git-lfs/releases/download/v3.5.1/git-lfs-linux-amd64-v3.5.1.tar.gz
tar -xf git-lfs-*.tar.gz
cd git-lfs-*
sudo ./install.sh

Windows

官方安装包：
1. 下载安装程序：Git LFS for Windows
2. 双击运行 .exe 文件，按向导完成安装。

2. 初始化 Git LFS

安装完成后，在终端运行以下命令启用 Git LFS：

复制代码

git lfs install

输出应为：Git LFS initialized.

3. 验证安装

检查 Git LFS 是否安装成功：

复制代码

git lfs version

正常输出示例：git-lfs/3.5.1 (GitHub; linux amd64; go 1.21.10)

4. 使用 Git LFS 管理文件

在项目中跟踪大文件（如 .psd, .zip）：

复制代码

# 跟踪特定文件类型
git lfs track "*.psd"

# 提交 .gitattributes 文件
git add .gitattributes
git commit -m "Track PSD files with Git LFS"

5. 常见问题

权限问题 ：若安装后仍报错，尝试使用 sudo 重新安装。
路径问题 ：确保 Git LFS 的安装路径已添加到系统的 PATH 环境变量中。
旧版本冲突：更新 Git LFS 至最新版本：
复制代码
```
git lfs update
```

完成以上步骤后，git lfs 命令即可正常使用！