uTools-Manuals/docs/git/git ls-tree.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-ls-tree  - 列出树对象的内容</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 ls-tree [-d] [-r] [-t] [-l] [-z]            [--name-only] [--name-status] [--full-name] [--full-tree] [--abbrev[=&lt;n&gt;]]            &lt;tree-ish&gt; [&lt;path&gt;…]</pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>描述</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>列出给定树对象的内容，例如“/ bin / ls -a”在当前工作目录中所做的内容。注意：</p></div></div><div class="doc-postil"><div class="c-markdown"><ul class="ul-level-0 list-paddingleft-2" style="margin: 10px 0px 10px 20px;"><li><p>该行为与“/ bin / ls”的行为稍有不同，因为它<code>&lt;path&gt;</code>仅表示要匹配的模式列表，例如，指定目录名称（不含<code>-r</code>）将具有不同的行为，并且参数的顺序无关紧要。</p></li></ul></div></div><div class="doc-postil"><div class="c-markdown"><ul class="ul-level-0 list-paddingleft-2" style="margin: 10px 0px 10px 20px;"><li><p>该行为与“/ bin / ls”的行为相似，<code>&lt;path&gt;</code>因为相对于当前工作目录而言。例如，当你在一个<code>sub</code>具有目录的目录中时<code>dir</code>，你可以运行<code>git ls-tree -r HEAD dir</code>以列出树的内容（即<code>sub/dir</code>在<code>HEAD</code>）。你不想给一棵树，是不是在根级别（例如，<code>git ls-tree -r HEAD:sub dir</code>在这种情况下），因为这将导致要求<code>sub/sub/dir</code>的<code>HEAD</code>承诺。但是，通过传递--full-tree 选项可以忽略当前工作目录。</p></li></ul></div></div><div class="doc-postil"><div class="c-markdown"><h2>选项</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>&lt;tree-ish&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>Id of a tree-ish.</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-d</p></div></div><div class="doc-postil"><div class="c-markdown"><p>仅显示已命名的树条目本身，而不是其子节点。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-r</p></div></div><div class="doc-postil"><div class="c-markdown"><p>递归到子树中。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-t</p></div></div><div class="doc-postil"><div class="c-markdown"><p>甚至在进行递归时也显示树条目。如果<code>-r</code>未通过，则无效。<code>-d</code>意味着<code>-t</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-l   --long</p></div></div><div class="doc-postil"><div class="c-markdown"><p>显示 blob（文件）条目的对象大小。</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>\ 0 行输出终止，不要引用文件名。有关更多信息，请参阅下面的 OUTPUT FORMAT。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--name-only   --name-status</p></div></div><div class="doc-postil"><div class="c-markdown"><p>仅列出文件名（而不是“长”输出），每行一个。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--abbrev=&lt;n&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>不显示完整的40字节十六进制对象行，只显示部分前缀。非默认位数可以用--abbrev = &lt;n&gt; 来指定。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--full-name</p></div></div><div class="doc-postil"><div class="c-markdown"><p>显示相对于当前工作目录的路径名称，而不是显示完整的路径名称。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--full-tree</p></div></div><div class="doc-postil"><div class="c-markdown"><p>不要将列表限制到当前工作目录。意味着 --full-name。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>&lt;path&gt;…</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当给出路径时，显示它们（请注意，这不是真正的原始路径名，而是一组匹配的模式列表）。否则，隐式使用树的根级作为唯一的路径参数。</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">&lt;mode&gt; SP &lt;type&gt; SP &lt;object&gt; TAB &lt;file&gt;</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>这种输出格式是什么兼容<code>--index-info --stdin</code>的<code>git update-index</code>期望。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当使用该<code>-l</code>选项时，格式更改为</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">&lt;mode&gt; SP &lt;type&gt; SP &lt;object&gt; SP &lt;object size&gt; TAB &lt;file&gt;</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>由&lt;object&gt;标识的对象大小以字节为单位，右对齐，最小宽度为7个字符。对象大小仅适用于 blob（文件）条目; 对于其他条目，<code>-</code>字符用于代替大小。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果没有这个<code>-z</code>选项，带有“不寻常”字符的路径名将按照配置变量的说明引用<code>core.quotePath</code>（请参阅 git-config [1]）。使用<code>-z</code>文件名是逐字输出的，并且该行由 NUL 字节终止。</p></div></div></div>