# 错误：LFS：无法签出 '<文件>'，因为它包含 LFS 指针内容但 Git LFS 未安装或未配置

- **ID:** `git/lfs-pointer-not-smudged`
- **领域:** git
- **类别:** install_error
- **验证级别:** ai_generated
- **修复率:** 93%

## 根因

由 Git LFS 跟踪的文件仅包含指针文本（例如 'version https://git-lfs.github.com/spec/v1'），而不是实际内容，因为 Git LFS 未安装、未初始化或缺少 smudge 过滤器。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| git-lfs 3.3.0 | active | — | — |
| git-lfs 3.4.1 | active | — | — |
| git-lfs 3.5.0 | active | — | — |

## 解决方案

1. ```
   Install Git LFS: 'brew install git-lfs' (macOS) or 'sudo apt-get install git-lfs' (Linux), then run 'git lfs install' to set up filters, and 'git lfs pull' to download the actual file content
   ```
2. ```
   If installation is not possible, manually download the file from the LFS remote server using the OID in the pointer file: 'curl -H "Accept: application/vnd.git-lfs+json" <lfs-endpoint>/objects/<oid>'
   ```

## 无效尝试

- **** — This bypasses LFS tracking, causing the large file to be stored directly in Git, defeating the purpose of LFS and bloating the repository. (70% 失败率)
- **** — The 'git lfs' command does not exist if LFS is not installed; the shell will return 'command not found'. (90% 失败率)