uTools-Manuals/docs/git/git check-ignore.html

<div class="c-markdown doc-markdown"><div class="doc-postil"><div class="c-markdown"><h2>命名</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>git-check-ignore  - 调试 gitignore /排除文件</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>概要</h2></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">git check-ignore [options] pathname…

git check-ignore [options] --stdin</pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>描述</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>对于通过命令行或文件via给出的每个路径名<code>--stdin</code>，检查该文件是否被.gitignore（或排除机制的其他输入文件）排除，并输出路径（如果排除）。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>默认情况下，跟踪文件根本不显示，因为它们不受排除规则限制; 但看到 '--no-index' 。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>选项</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>-q, --quiet</p></div></div><div class="doc-postil"><div class="c-markdown"><p>不输出任何内容，只需设置退出状态即可。这只对一个路径名有效。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-v, --verbose</p></div></div><div class="doc-postil"><div class="c-markdown"><p>还输出有关每个给定路径名的匹配模式（如果有）的详细信息。有关排除源内部和之间的优先规则，请参阅 gitignore [5]。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--stdin</p></div></div><div class="doc-postil"><div class="c-markdown"><p>从标准输入读取路径名，每行一个，而不是命令行。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-z</p></div></div><div class="doc-postil"><div class="c-markdown"><p>输出格式被修改为机器可分析的（见下文）。如果<code>--stdin</code>还给出，输入路径用NUL字符而不是换行字符分隔。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-n, --non-matching</p></div></div><div class="doc-postil"><div class="c-markdown"><p>显示与任何模式不匹配的给定路径。这仅在<code>--verbose</code>启用时才有意义，否则将无法区分匹配模式的路径和不匹配的路径。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--no-index</p></div></div><div class="doc-postil"><div class="c-markdown"><p>进行检查时不要查看索引。这可以用来调试为什么路径被例如跟踪，<code>git add .</code>并且不被用户期望的规则忽略，或者当开发包括否定的模式以匹配先前添加的路径时<code>git add -f</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>输出</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>默认情况下，将输出与忽略模式匹配的任何给定路径名，每行一个。如果没有模式匹配给定的路径，则不会为该路径输出任何内容; 这意味着路径不会被忽略。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果<code>--verbose</code>指定，输出是一系列格式的行：</p></div></div><div class="doc-postil"><div class="c-markdown"><p>&lt;source&gt; &lt;COLON&gt; &lt;linenum&gt; &lt;COLON&gt; &lt;pattern&gt; &lt;HT&gt; &lt;pathname&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>&lt;pathname&gt;是被查询文件的路径，&lt;pattern&gt;是匹配模式，&lt;source&gt;是模式的源文件，&lt;linenum&gt;是该源文件中模式的行号。如果模式包含<code>!</code>前缀或<code>/</code>后缀，它将保留在输出中。引用<code>core.excludesFile</code>或相对于存储库根<code>.git/info/exclude</code>目录指定的文件或每个目录排除文件时，&lt;source&gt;将是绝对路径。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果<code>-z</code>指定，则输出中的路径名由空字符分隔; 如果<code>--verbose</code>也被指定，则也使用空字符而不是冒号和硬标签：</p></div></div><div class="doc-postil"><div class="c-markdown"><p>&lt;source&gt; &lt;NULL&gt; &lt;linenum&gt; &lt;NULL&gt; &lt;pattern&gt; &lt;NULL&gt; &lt;pathname&gt; &lt;NULL&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果<code>-n</code>或者<code>--non-matching</code>被指定，则也会输出不匹配的路径名，在这种情况下，每个输出记录中除&lt;pathname&gt;之外的所有字段都将为空。这在非交互式运行时非常有用，因此文件可以增量流式传输到长时间运行的检查忽略进程的STDIN，并且对于其中的每个文件，STDOUT都会指示该文件是否匹配模式。（如果没有这个选项，就不可能判断给定文件的输出缺失是否意味着它不匹配任何模式，或者输出还没有生成。）</p></div></div><div class="doc-postil"><div class="c-markdown"><p>缓冲发生<code>GIT_FLUSH</code>在git [1]中的选项下。调用者负责避免溢出输入缓冲区或从空输出缓冲区读取引起的死锁。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>退出状态</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>0</p></div></div><div class="doc-postil"><div class="c-markdown"><p>一个或多个提供的路径被忽略。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>1</p></div></div><div class="doc-postil"><div class="c-markdown"><p>没有提供的路径被忽略。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>128</p></div></div><div class="doc-postil"><div class="c-markdown"><p>遇到致命错误。</p></div></div></div>