uTools-Manuals/docs/git/git symbolic-ref.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-symbolic-ref  - 读取，修改和删除符号引用</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 symbolic-ref [-m &lt;reason&gt;] &lt;name&gt; &lt;ref&gt;git symbolic-ref [-q] [--short] &lt;name&gt;git symbolic-ref --delete [-q] &lt;name&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>给定一个参数，读取哪个分支头部给定的符号ref引用并输出其相对于<code>.git/</code>目录的路径。通常，您会<code>HEAD</code>以&lt;name&gt;参数的形式提供您的工作树所在的分支。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>给定两个参数，创建或更新符号ref &lt;name&gt;以指向给定分支&lt;ref&gt;。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>给定<code>--delete</code>和额外的参数，删除给定的符号参考。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>符号ref是一个常规文件，它存储了一个以字符串开头的字符串<code>ref: refs/</code>。例如，你<code>.git/HEAD</code>的内容是一个普通文件<code>ref: refs/heads/master</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>-d   --delete</p></div></div><div class="doc-postil"><div class="c-markdown"><p>删除符号ref &lt;名称&gt;。</p></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>如果&lt;name&gt;不是符号引用，而是分离的HEAD，则不要发出错误消息; 而是静静地退出非零状态。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--short</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当示出了作为一个符号REF &lt;名称&gt;的值，尽量缩短值，例如从<code>refs/heads/master</code>到<code>master</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-m</p></div></div><div class="doc-postil"><div class="c-markdown"><p>使用&lt;reason&gt;更新&lt;名称&gt;的reflog。这仅在创建或更新符号引用时有效。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>注意</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>过去，这<code>.git/HEAD</code>是一个象征性的链接<code>refs/heads/master</code>。当我们想切换到另一个分支时，我们做了<code>ln -sf refs/heads/newbranch .git/HEAD</code>，当我们想知道我们在哪个分支时，我们做到了<code>readlink .git/HEAD</code>。但符号链接不是完全可移植的，因此它们现在已被弃用，并且默认情况下使用符号引用（如上所述）。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果符号ref的内容打印正确，<code>git symbolic-ref</code>将以状态0退出，如果请求的名称不是符号参考，则为状态1;如果发生另一错误，则为128。</p></div></div></div>