首页/开发/Git 与协作速查/git check-ignore 排查忽略原因
Git 基础与命令88 条

git check-ignore 排查忽略原因

定位「为什么这个文件被忽略了」:-v 显示命中的规则与来源文件;--no-index 可检查未被跟踪的路径。

Git 与协作速查开发更新于 2026-10-12
用途调试忽略规则
语法git check-ignore [-v] <路径>
输出来源文件、行号、规则、路径依次排列

常用示例

常用示例
git check-ignore -v build/app.log
git check-ignore -v .env
git check-ignore --no-index some-dir
新同事「文件加不进仓库」时,先跑一遍 check-ignore,比逐条读 .gitignore 快得多。

易错点

  • 已跟踪文件不会命中忽略规则,check-ignore 无输出不代表规则写错
  • -v 只在命中时显示规则;没有输出说明该路径其实没被忽略

数据来源与参考

  • Git 官方文档:git-check-ignore
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌