git: 'lfs' is not a git command

您遇到的错误 `git: 'lfs' is not a git command` 表明 **Git LFS 未正确安装或配置**。以下是完整的排查与解决方法，结合搜索结果的多个解决方案整理：

---

## 一、**错误原因分析**
1. **未安装 Git LFS**
   若未安装 Git LFS，Git 无法识别 `lfs` 子命令，导致报错。

2. **安装不完整**
   部分操作系统（如 Windows）需确保安装时勾选 **“将 Git LFS 添加到系统 PATH”**，否则命令行无法调用相关指令。

3. **环境变量未更新**
   Linux/macOS 用户可能需手动刷新 Shell 配置（如 `source ~/.bashrc`）或重启终端。

---

## 二、**分步解决方案**
### 1. **确认 Git LFS 是否已安装**
- **检查版本**：
  ```bash
  git lfs version
  ```
  - **输出示例**：
    ```
    git-lfs/3.3.0 (GitHub; linux amd64; go 1.20.3)
    ```
  - **若提示命令不存在**：说明未安装或安装失败，需重新安装 。

### 2. **重新安装 Git LFS**
根据操作系统选择安装方式：
- **Windows**：
  1. 从 [Git LFS 官网](https://git-lfs.com) 下载安装包。
  2. 运行安装程序，**确保勾选 “Add Git LFS to PATH”** 。
  3. 重启终端验证：`git lfs version`。

- **Linux（Ubuntu/Debian）**：
  ```bash
  # 推荐使用包管理器安装
  sudo apt-get update && sudo apt-get install git-lfs
  ```
  若提示包不存在，改用源码安装：
  ```bash
  curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash
  sudo apt-get install git-lfs
  ```

- **macOS**：
  ```bash
  # 使用 Homebrew 安装
  brew install git-lfs
  ```

### 3. **初始化 Git LFS**
安装完成后，在任意目录执行：
```bash
git lfs install
```
- **预期输出**：`Git LFS initialized.`。
- **若仍报错**：尝试全局配置：
  ```bash
  git config --global credential.helper cache
  ```

### 4. **验证环境变量**
- **Windows**：检查系统环境变量是否包含 Git LFS 路径（如 `C:\Program Files\Git LFS`）。
- **Linux/macOS**：确认 `which git-lfs` 返回有效路径，若无则手动添加：
  ```bash
  export PATH=$PATH:/usr/local/bin/git-lfs  # 路径可能因安装位置而异
  ```

---

## 三、**常见问题补充**
1. **安装后仍提示命令不存在**
   - **原因**：Shell 缓存未更新或安装路径未加入 PATH。
   - **解决**：重启终端或手动执行 `hash -r` 刷新缓存。

2. **权限问题（Linux/macOS）**
   若安装时未使用 `sudo`，可能导致权限不足。重新以管理员权限安装：
   ```bash
   sudo apt-get install git-lfs  # Ubuntu
   sudo brew install git-lfs     # macOS（若 Homebrew 安装失败）
   ```

3. **企业网络限制**
   若公司网络屏蔽 Git LFS 下载，需联系 IT 部门开放访问 `github.com` 和 `packagecloud.io`。

---

## 四、**验证安装成功**
完成上述步骤后，运行以下命令验证：
```bash
git lfs env  # 查看 Git LFS 环境配置
git lfs track "*.psd"  # 测试文件跟踪功能
```
若输出无错误，则表明 Git LFS 已正确安装。

---

通过以上步骤，您应该能解决 `git: 'lfs' is not a git command` 的问题。若仍遇到困难，可参考 [Git LFS 官方文档](https://git-lfs.github.com) 或上述来源。