RUNBOOK / Git / SSH
Git LFS 文件显示为 pointer：初始化与仓库对象边界
仓库中的大文件显示为 Git LFS pointer 文本，而不是预期的二进制内容。
故障现象与判断依据
最可能原因
GitHub 文档说明 Git LFS 在 Git 仓库中保存的是指向实际大对象的 pointer；先确认本机 LFS 已初始化，再判断对象获取与仓库策略。
LOG$ git lfs install
Git LFS initialized.
version https://git-lfs.github.com/spec/v1
oid sha256:<object-sha256>
size <bytes>安全诊断
以下命令用于读取状态、验证解析或复现请求；先确认目标主机、权限与影响范围。命令中的占位符必须替换为当前环境的实际值。
READ / VERIFYgit lfs install
# 检查当前仓库中由 LFS 管理的文件
git lfs ls-files
# 先确认远端访问与团队策略，再获取 LFS 对象
git lfs pull推荐修复步骤
- 1执行 git lfs install，并确认官方文档所示的 Git LFS initialized 输出。
- 2检查当前文件是否是 LFS pointer；不要把 pointer 文本误当作已损坏的二进制文件。
- 3在已确认远端与访问权限后，再按团队的 LFS 获取流程拉取对象；不要通过删除 .git 或跳过校验绕过问题。
验证、限制与回滚
修复后的验证
git lfs install 返回成功；仓库策略允许的 LFS 对象可按预期得到，普通 Git 文件不受影响。
风险提示与回滚
不要以关闭证书校验、删除全部缓存、无限重试、关闭防火墙或放宽到 chmod 777 来替代根因定位。任何配置变更前先保留原文件和校验结果；若验证失败，恢复该备份并重新采集日志。
可信来源与适用边界
参考来源Installing Git Large File Storage - GitHub Docs ↗
git lfs install reports Git LFS initialized; LFS stores pointer files in Git 此页将环境级案例与本 Runbook 的检查步骤分开呈现，不能把示例日志当作当前服务器的真实事件。