lfs env 是什么
git lfs env 打印 LFS 的环境诊断信息：端点（对象实际推到哪）、本地工作目录与缓存目录、版本与相关配置。排查三类问题最常用：推到哪个存储、缓存占了多少空间、配置到底被哪一层覆盖。CI 与本地行为不一致时，对比两边 env 输出，端点与缓存目录差异往往就是根因。
基本信息
| 用途 | 打印 LFS 环境信息 |
|---|---|
| 关注字段 | Endpoint、LocalWorkingDir、LocalMediaDir、对象大小阈值 |
| 相关命令 | git lfs version / git lfs status / git lfs ls-files |
| 覆盖层级 | 系统 / 全局 / 仓库 / 环境变量逐层覆盖 |
| 排查用法 | 对比 CI 与本地的端点、缓存目录差异 |
| 隐私注意 | 输出路径可能含用户名，外贴前先整理 |
典型使用场景
- 推送去向确认：核对对象实际推到了哪个 LFS 端点
- 缓存空间排查：缓存目录占满磁盘时先定位 LocalMediaDir
- 配置覆盖定位：多层配置下出现意外值时逐层找来源
- CI 对照：流水线与本地行为不一致时对比两侧 env 输出
- 迁移切换：更换 LFS 服务后核对端点是否已生效
- 支持排错：报错信息模糊时先收集 env 作为上下文
常用示例
常用示例
git lfs env # 完整环境信息：端点、缓存目录、版本
git lfs version # 单独确认 LFS 版本
git lfs status # 查看当前暂存与对象的 LFS 处理状态
git lfs ls-files --size # 列出被 LFS 跟踪的文件及大小关键字段读法
| 字段 | 含义 | 排查用途 |
|---|---|---|
| Endpoint | LFS 服务端点 | 推送去向异常时先看它 |
| LocalWorkingDir | 当前工作目录 | 确认在哪个仓库里执行 |
| LocalMediaDir | 本地对象缓存目录 | 磁盘占用与清理的对象 |
| 大小阈值 | 纳入 LFS 的判定规则 | 该走 LFS 却没走的文件查这里 |
CI 与本地行为不一致时，先对比两边的 env 输出，端点与缓存目录差异往往是根因。
配置按系统、全局、仓库、环境变量逐层覆盖：排查时先看实际生效值来自哪一层，再决定改哪里。
env 输出含本地路径与用户名，贴到公开 Issue 前先脱敏。