設定和配置
獲取和建立專案
基本快照
分支與合併
共享和更新專案
檢查和比較
打補丁
除錯
電子郵件
外部系統
伺服器管理
指南
管理
底層命令
- 2.48.1 → 2.50.1 無更改
-
2.48.0
2025-01-10
- 2.46.1 → 2.47.3 無更改
-
2.46.0
2024-07-29
- 2.42.1 → 2.45.4 無更改
-
2.42.0
2023-08-21
- 2.40.1 → 2.41.3 無更改
-
2.40.0
2023-03-12
- 2.28.1 → 2.39.5 無更改
-
2.28.0
2020-07-27
- 2.25.3 → 2.27.1 無更改
-
2.25.2
2020-03-17
- 2.24.1 → 2.25.1 無更改
-
2.24.0
2019-11-04
- 2.22.1 → 2.23.4 無更改
-
2.22.0
2019-06-07
- 2.18.1 → 2.21.4 無變更
-
2.18.0
2018-06-21
- 2.9.5 → 2.17.6 無變化
-
2.8.6
2017-07-30
- 2.7.6 無更改
-
2.6.7
2017-05-05
- 2.1.4 → 2.5.6 無更改
-
2.0.5
2014-12-17
概要
git ls-remote [--branches] [--tags] [--refs] [--upload-pack=<exec>] [-q | --quiet] [--exit-code] [--get-url] [--sort=<key>] [--symref] [<repository> [<patterns>…]]
選項
- -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^{}