©
This document usesPHP Chinese website manualRelease
git-check-ignore - 调试 gitignore /排除文件
git check-ignore [options] pathname… git check-ignore [options] --stdin
对于通过命令行或文件via给出的每个路径名--stdin
,检查该文件是否被.gitignore(或排除机制的其他输入文件)排除,并输出路径(如果排除)。
默认情况下,跟踪文件根本不显示,因为它们不受排除规则限制; 但看到 '--no-index' 。
-q, --quiet
不输出任何内容,只需设置退出状态即可。这只对一个路径名有效。
-v, --verbose
还输出有关每个给定路径名的匹配模式(如果有)的详细信息。有关排除源内部和之间的优先规则,请参阅 gitignore [5]。
--stdin
从标准输入读取路径名,每行一个,而不是命令行。
-z
输出格式被修改为机器可分析的(见下文)。如果--stdin
还给出,输入路径用NUL字符而不是换行字符分隔。
-n, --non-matching
显示与任何模式不匹配的给定路径。这仅在--verbose
启用时才有意义,否则将无法区分匹配模式的路径和不匹配的路径。
--no-index
进行检查时不要查看索引。这可以用来调试为什么路径被例如跟踪,git add .
并且不被用户期望的规则忽略,或者当开发包括否定的模式以匹配先前添加的路径时git add -f
。
默认情况下,将输出与忽略模式匹配的任何给定路径名,每行一个。如果没有模式匹配给定的路径,则不会为该路径输出任何内容; 这意味着路径不会被忽略。
如果--verbose
指定,输出是一系列格式的行:
如果-z
指定,则输出中的路径名由空字符分隔; 如果--verbose
也被指定,则也使用空字符而不是冒号和硬标签:
如果-n
或者--non-matching
被指定,则也会输出不匹配的路径名,在这种情况下,每个输出记录中除
缓冲发生GIT_FLUSH
在git [1]中的选项下。调用者负责避免溢出输入缓冲区或从空输出缓冲区读取引起的死锁。
0
一个或多个提供的路径被忽略。
1
没有提供的路径被忽略。
128
遇到致命错误。