?
This document uses PHP Chinese website manual Release
git-symbolic-ref - 讀取,修改和刪除符號(hào)引用
git symbolic-ref [-m <reason>] <name> <ref>git symbolic-ref [-q] [--short] <name>git symbolic-ref --delete [-q] <name>
給定一個(gè)參數(shù),讀取哪個(gè)分支頭部給定的符號(hào)ref引用并輸出其相對(duì)于.git/
目錄的路徑。通常,您會(huì)HEAD
以<name>參數(shù)的形式提供您的工作樹(shù)所在的分支。
給定兩個(gè)參數(shù),創(chuàng)建或更新符號(hào)ref <name>以指向給定分支<ref>。
給定--delete
和額外的參數(shù),刪除給定的符號(hào)參考。
符號(hào)ref是一個(gè)常規(guī)文件,它存儲(chǔ)了一個(gè)以字符串開(kāi)頭的字符串ref: refs/
。例如,你.git/HEAD
的內(nèi)容是一個(gè)普通文件ref: refs/heads/master
。
-d --delete
刪除符號(hào)ref <名稱(chēng)>。
-q --quiet
如果<name>不是符號(hào)引用,而是分離的HEAD,則不要發(fā)出錯(cuò)誤消息; 而是靜靜地退出非零狀態(tài)。
--short
當(dāng)示出了作為一個(gè)符號(hào)REF <名稱(chēng)>的值,盡量縮短值,例如從refs/heads/master
到master
。
-m
使用<reason>更新<名稱(chēng)>的reflog。這僅在創(chuàng)建或更新符號(hào)引用時(shí)有效。
過(guò)去,這.git/HEAD
是一個(gè)象征性的鏈接refs/heads/master
。當(dāng)我們想切換到另一個(gè)分支時(shí),我們做了ln -sf refs/heads/newbranch .git/HEAD
,當(dāng)我們想知道我們?cè)谀膫€(gè)分支時(shí),我們做到了readlink .git/HEAD
。但符號(hào)鏈接不是完全可移植的,因此它們現(xiàn)在已被棄用,并且默認(rèn)情況下使用符號(hào)引用(如上所述)。
如果符號(hào)ref的內(nèi)容打印正確,git symbolic-ref
將以狀態(tài)0退出,如果請(qǐng)求的名稱(chēng)不是符號(hào)參考,則為狀態(tài)1;如果發(fā)生另一錯(cuò)誤,則為128。