遇到 git-lfs: command not found
错误,表示你的系统中未安装 Git Large File Storage (LFS) 扩展工具。以下是针对不同操作系统的解决方案:
1. 安装 Git LFS
根据你的操作系统选择安装方式:
macOS
-
使用 Homebrew(推荐):
brew install git-lfs
-
手动安装:
-
下载安装包:Git LFS 官网
-
解压并运行安装脚本:
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
-
官方安装包:
-
下载安装程序:Git LFS for Windows
-
双击运行
.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
命令即可正常使用!