簡體中文 ▾ 主題 ▾ 最新版本 ▾ git-ls-remote 最後更新於 2.48.0

名稱

git-ls-remote - 列出遠端倉庫中的引用

概要

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

描述

顯示遠端倉庫中可用的引用及其關聯的提交 ID。

選項

-b
--branches
-t
--tags

分別限制只顯示本地分支和本地標籤。這些選項是互斥的;當兩者都給定時,會顯示儲存在 refs/heads 和 refs/tags 中的引用。請注意,--heads-h--branches-b 的已棄用同義詞,將來可能會被移除。另請注意,git ls-remote -h 在命令列上不帶其他任何引數時會顯示幫助,這與其他 Git 子命令保持一致。

--refs

在輸出中不顯示剝離的標籤或偽引用(如 HEAD)。

-q
--quiet

不將遠端 URL 列印到標準錯誤輸出。

--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> 時,它們將按照命令列中列出的順序全部發送到另一側。如果命令列中未給出 --server-option=<option>,則使用配置變數 remote.<name>.serverOption 的值代替。

<repository>

要查詢的“遠端”倉庫。此引數可以是 URL,也可以是遠端的名稱(參見 git-fetch[1] 的 GIT URLS 和 REMOTES 部分)。

<patterns>…​

未指定時,將顯示所有引用(經過 --heads 和 --tags 過濾後)。指定 <patterns>…​ 時,僅顯示匹配一個或多個給定模式的引用。每個模式都被解釋為一個 glob(參見 gitglossary[7] 中的 glob),它將與引用的“尾部”匹配,匹配可以從引用的開頭開始(因此像 refs/heads/foo 這樣的全名會匹配),也可以從斜槓分隔符開始(因此 bar 會匹配 refs/heads/bar 但不匹配 refs/heads/foobar)。

輸出

輸出格式為

<oid> TAB <ref> LF

顯示帶註解的標籤時,除非給定 --refs,否則會顯示兩行:一行將標籤本身的引用名稱顯示為 <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

Git[1] 套件的一部分

scroll-to-top