如何查询Git仓库中单个文件的完整Git状态（含忽略/未跟踪等状态）

直接使用git ls-files命令即可覆盖所有需要判定的文件状态，无需组合多条命令做交叉判断，核心命令如下：

git ls-files --stage --others --ignored --exclude-standard <目标文件路径>

不同返回结果直接对应四类状态，无需额外解析：

• 命令无任何输出：文件为已跟踪但未修改状态，工作区内容和Git索引中存储的版本完全一致，无改动
• 输出内容为文件哈希、权限模式、索引编号加文件路径（格式参考100644 d3e0b9c7a1f2 0 test.js）：文件为已跟踪且已修改/已暂存状态，文件已纳入Git版本管控，当前暂存区或工作区内容与HEAD提交版本存在差异
• 输出内容以? 开头，后跟文件路径：文件为未跟踪且未被忽略状态，Git未将该文件纳入版本管控，且文件未命中任何忽略规则
• 输出内容以! 开头，后跟文件路径：文件为未跟踪且被忽略状态，Git未将该文件纳入版本管控，且文件命中了.gitignore、全局忽略配置或仓库本地忽略规则

如果需要更易读的稳定结构化输出，也可以使用Git专为脚本解析设计的porcelain格式状态命令：

git status --porcelain=v2 --ignored <目标文件路径>

该命令的返回规则和上述git ls-files完全对齐，状态标识更明确，且输出格式不会随Git版本迭代发生变动，适合写在自动化脚本中做状态判断。

之前提到的几个常用命令存在局限性，本质是因为这些命令的设计目标就不是输出全量状态：git status默认仅展示存在变动的文件，未修改的跟踪文件不会出现在输出中；git check-ignore默认仅校验未跟踪文件的忽略匹配结果，不会读取索引中的跟踪文件信息。

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