新加坡 11-08 01:48 · 吉隆坡 01:48 · 雅加达 00:48 · 曼谷 00:48 · 马尼拉 01:48 · 胡志明 00:48 · 北京 01:48 · 东京 02:48 · 伦敦 17:48 · 纽约 12:48
Amy 原创整理｜资料核验：2026-11-05
排查某个路径受哪条忽略规则影响，可以使用git check-ignore的verbose模式。Git官方文档说明，这时会显示匹配规则的来源文件、行号、规则文本和所查询的路径，便于回到具体配置位置检查。
容易误读的地方是：规则若以!开头，它是一个否定规则，匹配意味着该路径没有被这条规则排除。所以不能只看到终端打印了路径，就断言它一定被忽略。
教学命令（路径是虚构示例）：
git check-ignore -v -- notes/example.txt
Amy建议：先读规则文本，再看它来自哪一个文件和哪一行；把该位置与自己的意图对照，而不是在根目录反复追加相似规则。默认情况下，已追踪的文件不会出现在检查结果里；需要研究规则本身时可了解--no-index，但它不会改变文件的追踪状态。
这些是只读诊断方法，不会替你删除、移出索引或修改任何文件。把“找到规则来源”和“决定修改规则”分开，能更清楚地解释一次调整会影响哪些路径。
补几条官方接口细节，配你这条用： 一是输出行的确切格式。<source>:<linenum>:<pattern> 加一个制表符再接 <pathname>；而且 pattern 里的 ! 前缀和结尾 / 都会原样保留在输出里，所以否定规则在终端这一行就能看出来，不用回文件找。四个字段顺序固定：来源文件、行号、规则文本、查询路径。 二是配合退出码判断更稳。官方EXIT STATUS：0=提供的路径里有被忽略的，1=全部没被忽略，128=致命错误。"有输出但退出码1"就是你标题说的情形——匹配到一条 ! 规则、路径并未被忽略。脚本里只看有没有输出会被这种case骗到。 三是 -n/--non-matching 会把没匹配任何规则的路径也打出来（除 pathname 外字段全空），配合 --stdin 做批量流式检查时，能区分"还没出结果"和"确实没规则管"；-z 则把分隔符换成NUL，路径含冒号或制表符时用它。 补充一点你已经提到的：--no-index 是排查"为什么 git add . 把它加进来了"用的，规则优先级（最后匹配的规则赢、! 的位置很关键）在 gitignore(5) 里，check-ignore 只负责指认命中了哪条。