Git
English ▾ 主題 ▾ 最新版本 ▾ git-symbolic-ref 最後更新於 2.43.0

名稱

git-symbolic-ref - 讀取、修改和刪除符號參考

概要

git symbolic-ref [-m <reason>] <name> <ref>
git symbolic-ref [-q] [--short] [--no-recurse] <name>
git symbolic-ref --delete [-q] <name>

描述

給定一個參數，讀取給定的符號參考指向哪個分支頭，並輸出其路徑，相對於 .git/ 目錄。通常您會給定 HEAD 作為 <name> 參數，以查看您的工作樹位於哪個分支上。

給定兩個參數，建立或更新一個符號參考 <name>，使其指向給定的分支 <ref>。

給定 --delete 和一個額外的參數，刪除給定的符號參考。

符號參考是一個常規檔案，儲存一個以 ref: refs/ 開頭的字串。例如，您的 .git/HEAD 是一個常規檔案，其內容為 ref: refs/heads/master。

選項

-d
--delete

刪除符號參考 <name>。

-q
--quiet

如果 <name> 不是符號參考而是分離的 HEAD，則不發出錯誤訊息；而是靜默地以非零狀態退出。

--short

當顯示 <name> 作為符號參考的值時，嘗試縮短該值，例如從 refs/heads/master 到 master。

--recurse
--no-recurse

當顯示 <name> 作為符號參考的值時，如果 <name> 指向另一個符號參考，則追蹤符號參考鏈，直到結果不再指向符號參考為止 (--recurse，這是預設值)。--no-recurse 只會在取消參考單一級別的符號參考後停止。

-m

使用 <reason> 更新 <name> 的 reflog。這僅在建立或更新符號參考時有效。

注意事項

在過去，.git/HEAD 是一個指向 refs/heads/master 的符號連結。當我們想要切換到另一個分支時，我們會執行 ln -sf refs/heads/newbranch .git/HEAD，當我們想要找出我們在哪個分支上時，我們會執行 readlink .git/HEAD。但符號連結並非完全可移植，因此它們現在已被棄用，並且預設使用符號參考（如上所述）。

如果符號參考的內容已正確列印，則 git symbolic-ref 將以狀態 0 退出；如果請求的名稱不是符號參考，則以狀態 1 退出；如果發生其他錯誤，則以 128 退出。

GIT

屬於 git[1] 套件的一部分

scroll-to-top