如何确认文件是否由git-lfs追踪？及未追踪文件迁移咨询

为什么文件有LFS属性却不在git lfs ls-files结果中？ #

• 文件已以普通Git对象存储：git lfs ls-files仅列出仓库中实际以LFS指针形式存储的文件。如果文件是在.gitattributes配置LFS规则之前提交的，或者提交时未安装Git LFS导致直接提交了原始大文件，那么即使后续配置了LFS属性，该文件依然是普通Git对象，不会出现在LFS列表中。git check-attr仅检查属性规则的配置，不反映文件在仓库中的实际存储状态。
• 属性配置未覆盖历史提交：如果.gitattributes的LFS规则是后来添加并提交的，之前提交历史中的文件不会自动转换为LFS指针，因此这些历史版本的文件不在git lfs ls-files的输出里，但当前工作区的属性检查会显示LFS配置。

更可靠的文件检查方法 #

• 验证文件是否为LFS指针：执行git cat-file -p <文件路径>，如果输出包含oid sha256:...和size ...字段，说明是LFS指针；否则就是普通Git文件。
• 使用git lfs status：该命令会直接显示工作区中哪些文件应该被LFS管理但实际未被追踪（例如标注Not in Git LFS的条目），比单纯对比文件列表更精准。
• 组合验证逻辑：编写脚本时，除了对比git ls-files和git lfs ls-files -n的结果，还要对差异文件执行git cat-file检查是否为指针，避免误判那些属性配置正确但实际已存储为指针的文件。

迁移未追踪文件到Git LFS的步骤 #

方式1：重写历史（彻底移除仓库中的大文件） #

适合仓库尚未公开或团队能配合同步历史的场景：

# 批量迁移指定类型或路径的文件，--everything会处理所有分支的历史
git lfs migrate import --include="*.ext" --everything
# 推送重写后的历史（注意：会覆盖远程分支，需提前和团队沟通）
git push --force

方式2：仅转换当前及未来提交（保留历史） #

适合不想修改历史的场景：

# 从Git缓存中移除文件（不删除本地文件）
git rm --cached <文件路径>
# 重新添加文件，此时Git LFS会根据属性规则生成指针
git add <文件路径>
# 提交更改
git commit -m "Migrate <文件路径> to Git LFS"
# 推送提交和LFS对象
git push
git lfs push origin <分支名>

内容的提问来源于stack exchange，提问作者LongTrail