Git
English ▾ 主題 ▾ 最新版本 ▾ git-ls-remote 最後更新於 2.46.0

名稱

git-ls-remote - 列出遠端儲存庫中的參考

概要

git ls-remote [--branches] [--tags] [--refs] [--upload-pack=<exec>]
	      [-q | --quiet] [--exit-code] [--get-url] [--sort=<key>]
	      [--symref] [<repository> [<patterns>…​]]

描述

顯示遠端儲存庫中可用的參考，以及相關的 commit ID。

選項

-b
--branches
-t
--tags

分別限制為僅限本機分支和本機標籤。這些選項並非互斥；當兩者都指定時，會顯示儲存在 refs/heads 和 refs/tags 中的參考。請注意，--heads 和 -h 是 --branches 和 -b 的已棄用同義詞，未來可能會移除。另請注意，在命令列上未使用其他任何內容的情況下使用 git ls-remote -h 會顯示說明，這與其他 git 子命令一致。

--refs

不要在輸出中顯示已剝離的標籤或類似 HEAD 的虛擬參考。

-q
--quiet

不要將遠端 URL 列印到 stderr。

--upload-pack=<exec>

指定遠端主機上 git-upload-pack 的完整路徑。這允許從透過 SSH 存取的儲存庫中列出參考，且 SSH 精靈不使用使用者設定的 PATH。

--exit-code

當在遠端儲存庫中找不到相符的參考時，以狀態「2」結束。通常，此命令會以狀態「0」結束，表示它已成功與遠端儲存庫通訊，無論是否找到任何相符的參考。

--get-url

展開給定遠端儲存庫的 URL，並將任何 "url.<base>.insteadOf" 組態設定納入考量 (請參閱git-config[1])，然後結束而不與遠端通訊。

--symref

除了它指向的物件外，當顯示符號參考時，還會顯示它指向的基礎參考。目前，upload-pack 僅顯示符號參考 HEAD，因此它將是 ls-remote 顯示的唯一一個。

--sort=<key>

根據給定的索引鍵排序。在值前面加上 - 以依值的降序排序。支援 "version:refname" 或 "v:refname" (標籤名稱會視為版本)。 "version:refname" 排序順序也可能會受到 "versionsort.suffix" 組態變數的影響。如需更多排序選項，請參閱git-for-each-ref[1]，但請注意，需要存取物件本身的索引鍵 (例如 committerdate) 對於尚未從遠端提取物件的參考將無法運作，並會提供 missing object 錯誤。

-o <option>
--server-option=<option>

使用通訊協定版本 2 通訊時，將給定的字串傳輸至伺服器。給定的字串不得包含 NUL 或 LF 字元。當給定多個 --server-option=<option> 時，它們會按照命令列上的列出順序全部傳送至另一端。

<repository>

要查詢的「遠端」儲存庫。此參數可以是 URL 或遠端名稱 (請參閱 git-fetch[1] 的 GIT URLS 和 REMOTES 區段)。

<patterns>…​

未指定時，會顯示所有參考 (在使用 --heads 和 --tags 篩選後)。當指定 <patterns>…​ 時，只會顯示符合一個或多個給定模式的參考。每個模式都會被解譯為 glob (請參閱 gitglossary[7] 中的 glob)，該 glob 會針對參考的「尾部」進行比對，比對方式是從參考的開頭 (因此像 refs/heads/foo 這樣的完整名稱會符合) 或從斜線分隔符號開始 (因此 bar 會符合 refs/heads/bar，但不會符合 refs/heads/foobar)。

輸出

輸出格式為

<oid> TAB <ref> LF

顯示註解標籤時，除非給定 --refs，否則會顯示兩行：一行使用標籤本身的 refname 作為 <ref>，另一行使用 <ref>，後面接著 ^{}。 後一行上的 <oid> 會顯示標籤指向的物件名稱。

範例

  • 列出所有參考 (包括符號參考和虛擬參考)，剝離標籤

    $ git ls-remote
27d43aaaf50ef0ae014b88bba294f93658016a2e	HEAD
950264636c68591989456e3ba0a5442f93152c1a	refs/heads/main
d9ab777d41f92a8c1684c91cfb02053d7dd1046b	refs/heads/next
d4ca2e3147b409459955613c152220f4db848ee1	refs/tags/v2.40.0
73876f4861cd3d187a4682290ab75c9dccadbc56	refs/tags/v2.40.0^{}

  • 列出符合給定模式的所有參考

    $ git ls-remote http://www.kernel.org/pub/scm/git/git.git master seen rc
5fe978a5381f1fbad26a80e682ddd2a401966740	refs/heads/master
c781a84b5204fb294c9ccc79f8b3baceeb32c061	refs/heads/seen

  • 僅列出符合給定萬用字元模式的標籤

    $ git ls-remote --tags http://www.kernel.org/pub/scm/git/git.git v\*
485a869c64a68cc5795dd99689797c5900f4716d	refs/tags/v2.39.2
cbf04937d5b9fcf0a76c28f69e6294e9e3ecd7e6	refs/tags/v2.39.2^{}
d4ca2e3147b409459955613c152220f4db848ee1	refs/tags/v2.40.0
73876f4861cd3d187a4682290ab75c9dccadbc56	refs/tags/v2.40.0^{}

另請參閱

git-check-ref-format[1].

GIT

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

scroll-to-top