git-rev-parse · Git 中文參考

# git-rev-parse > 原文： [https://git-scm.com/docs/git-rev-parse](https://git-scm.com/docs/git-rev-parse) ## 名稱 git-rev-parse - 挑選和按摩參數 ## 概要 ``` git rev-parse [<options>] <args>…? ``` ## 描述許多Git瓷器命令采用混合標志（即以破折號 _-_ 開頭的參數）和用于內部使用的底層 _git rev-list_ 命令的參數以及用于標記和參數的參數。他們在 _git rev-list_ 下游使用的其他命令。此命令用于區分它們。 ## OPTIONS ### 操作模式這些選項中的每一個都必須首先出現在命令行中。 ``` --parseopt ``` 在選項解析模式下使用 _git rev-parse_ （參見下面的PARSEOPT部分）。 ``` --sq-quote ``` 在shell引用模式下使用 _git rev-parse_ （參見下面的SQ-QUOTE部分）。與下面的`--sq`選項相比，此模式僅引用。命令輸入沒有其他任何操作。 ### --parseopt的選項 ``` --keep-dashdash ``` 僅在`--parseopt`模式下有意義。告訴選項解析器回顯第一個`--`遇到而不是跳過它。 ``` --stop-at-non-option ``` 僅在`--parseopt`模式下有意義。允許選項解析器在第一個非選項參數處停止。這可用于解析自帶選項的子命令。 ``` --stuck-long ``` 僅在`--parseopt`模式下有意義。如果可用，以長格式輸出選項，并且參數卡住。 ### 過濾選項 ``` --revs-only ``` 不要輸出不適用于 _git rev-list_ 命令的標志和參數。 ``` --no-revs ``` 不要輸出 _git rev-list_ 命令的標志和參數。 ``` --flags ``` 不要輸出非標志參數。 ``` --no-flags ``` 不要輸出標志參數。 ### 輸出選項 ``` --default <arg> ``` 如果用戶沒有給出參數，請改用`<arg>`。 ``` --prefix <arg> ``` 表現為好像從工作樹的`<arg>`子目錄調用了 _git rev-parse_ 。任何相對文件名都被解析為好像它們以`<arg>`為前綴，并將以該格式打印。這可用于將參數轉換為子目錄中運行的命令，以便在移動到存儲庫的頂級后仍可使用它們。例如： ``` prefix=$(git rev-parse --show-prefix) cd "$(git rev-parse --show-toplevel)" # rev-parse provides the -- needed for 'set' eval "set $(git rev-parse --sq --prefix "$prefix" -- "$@")" ``` ``` --verify ``` 驗證是否提供了一個參數，并且可以將其轉換為可用于訪問對象數據庫的原始20字節SHA-1。如果是這樣，將其發射到標準輸出;否則，錯誤。如果要確保輸出實際命名對象數據庫中的對象和/或可以用作所需的特定對象類型，可以將`^{type}`剝離運算符添加到參數中。例如，`git rev-parse "$VAR^{commit}"`將確保`$VAR`命名為commit-ish的現有對象（即提交或指向提交的帶注釋標記）。為了確保`$VAR`命名任何類型的現有對象，可以使用`git rev-parse "$VAR^{object}"`。 ``` -q ``` ``` --quiet ``` 僅在`--verify`模式下有意義。如果第一個參數不是有效的對象名，請不要輸出錯誤消息;而是以靜默方式退出非零狀態。有效對象名稱的SHA-1在成功時打印到stdout。 ``` --sq ``` 通常每個標志和參數輸出一行。此選項使輸出成為一行，正確引用以供shell使用。當你希望你的參數包含空格和換行符時很有用（例如當使用pickaxe `-S`和 _git diff- *_ 時）。與`--sq-quote`選項相反，命令輸入仍然像往常一樣解釋。 ``` --short[=length] ``` 與`--verify`相同，但將對象名稱縮短為至少包含`length`字符的唯一前綴。最小長度為4，默認值為`core.abbrev`配置變量的有效值（參見 [git-config [1]](https://git-scm.com/docs/git-config) ）。 ``` --not ``` 顯示對象名稱時，請在 _^_ 前面添加前綴，并從已有的對象名稱中刪除 _^_ 前綴。 ``` --abbrev-ref[=(strict|loose)] ``` 對象名稱的非模糊短名稱。選項core.warnAmbiguousRefs用于選擇嚴格的縮寫模式。 ``` --symbolic ``` 通常，對象名稱以SHA-1形式輸出（可能有 _^_ 前綴）;此選項使它們以盡可能接近原始輸入的形式輸出。 ``` --symbolic-full-name ``` 這類似于--symbolic，但它省略了不是引用的輸入（即分支或標記名稱;或者更明確地消除歧義“head / master”形式，當您想要命名“master”分支時，有一個不幸的命名標記“master”），并將它們顯示為完整的重新命名（例如“refs / heads / master”）。 ### 對象選項 ``` --all ``` 顯示`refs/`中找到的所有引用。 ``` --branches[=pattern] ``` ``` --tags[=pattern] ``` ``` --remotes[=pattern] ``` 分別顯示所有分支，標簽或遠程跟蹤分支（即分別在`refs/heads`，`refs/tags`或`refs/remotes`中找到的refs）。如果給出`pattern`，則僅顯示與給定shell glob匹配的refs。如果模式不包含通配符（`?`，`*`或`[`），則通過附加`/*`將其轉換為前綴匹配。 ``` --glob=pattern ``` 顯示與shell glob模式`pattern`匹配的所有引用。如果模式不以`refs/`開頭，則會自動添加前綴。如果模式不包含通配符（`?`，`*`或`[`），則通過附加`/*`將其轉換為前綴匹配。 ``` --exclude=<glob-pattern> ``` 不包括引用匹配_< glob-pattern>_ 否則會考慮下一個`--all`，`--branches`，`--tags`，`--remotes`或`--glob`。重復此選項會累積排除模式，直至下一個`--all`，`--branches`，`--tags`，`--remotes`或`--glob`選項（其他選項或參數不會清除累積模式）。當應用于`--branches`，`--tags`或`--remotes`時，給出的模式不應以`refs/heads`，`refs/tags`或`refs/remotes`開始，并且當應用于`--glob`時，它們必須以`refs/`開頭]或`--all`。如果打算使用尾隨 _/ *_ ，則必須明確給出。 ``` --disambiguate=<prefix> ``` 顯示名稱以給定前綴開頭的每個對象。 <前綴>必須至少有4個十六進制數字才能避免錯誤地列出存儲庫中的每個對象。 ### 文件選項 ``` --local-env-vars ``` 列出存儲庫本地的GIT_ *環境變量（例如GIT_DIR或GIT_WORK_TREE，但不是GIT_EDITOR）。僅列出變量的名稱，而不是它們的值，即使它們已設置。 ``` --git-dir ``` 如果已定義，則顯示`$GIT_DIR`。否則顯示.git目錄的路徑。顯示的路徑，相對時，相對于當前工作目錄。如果未定義`$GIT_DIR`并且未檢測到當前目錄位于Git存儲庫或工作樹中，則將消息打印到stderr并以非零狀態退出。 ``` --absolute-git-dir ``` 與`--git-dir`類似，但其輸出始終是規范化的絕對??路徑。 ``` --git-common-dir ``` 如果已定義則顯示`$GIT_COMMON_DIR`，否則顯示`$GIT_DIR`。 ``` --is-inside-git-dir ``` 當前工作目錄低于存儲庫目錄時打印“true”，否則為“false”。 ``` --is-inside-work-tree ``` 當前工作目錄在存儲庫的工作樹內打印“true”，否則為“false”。 ``` --is-bare-repository ``` 當存儲庫裸露時為“true”，否則為“false”。 ``` --is-shallow-repository ``` 當存儲庫淺時打印“true”，否則為“false”。 ``` --resolve-git-dir <path> ``` 檢查< path>是指向有效存儲庫的有效存儲庫或gitfile，并打印存儲庫的位置。如果< path>是一個gitfile然后打印到真實存儲庫的已解析路徑。 ``` --git-path <path> ``` 解析“$ GIT_DIR /< path>”并考慮其他路徑重定位變量，如$ GIT_OBJECT_DIRECTORY，$ GIT_INDEX_FILE ....例如，如果$ GIT_OBJECT_DIRECTORY設置為/ foo / bar，則“git rev-parse --git-path objects / abc”返回/ foo / bar / abc。 ``` --show-cdup ``` 從子目錄調用該命令時，顯示相對于當前目錄的頂級目錄的路徑（通常是“../”序列或空字符串）。 ``` --show-prefix ``` 從子目錄調用該命令時，顯示當前目錄相對于頂級目錄的路徑。 ``` --show-toplevel ``` 顯示頂級目錄的絕對路徑。 ``` --show-superproject-working-tree ``` 顯示使用當前存儲庫作為其子模塊的超級項目工作樹（如果存在）的根的絕對路徑。如果當前存儲庫未被任何項目用作子模塊，則不輸出任何內容。 ``` --shared-index-path ``` 在拆分索引模式下顯示共享索引文件的路徑，如果不在拆分索引模式下則顯示為空。 ### 其他選擇 ``` --since=datestring ``` ``` --after=datestring ``` 解析日期字符串，并為 _git rev-list_ 輸出相應的--max-age =參數。 ``` --until=datestring ``` ``` --before=datestring ``` 解析日期字符串，并為 _git rev-list_ 輸出相應的--min-age =參數。 ``` <args>…? ``` 要解析的標志和參數。 ## 指定修訂修訂參數_< rev>_ 通常（但不一定）命名提交對象。它使用所謂的_擴展SHA-1_ 語法。以下是拼寫對象名稱的各種方法。列表末尾附近列出的名稱包含提交中包含的樹和blob。 | 注意 | 本文檔顯示了git看到的“原始”語法。 shell和其他UI可能需要額外的引用來保護特殊字符并避免單詞拆分。 | ``` <sha1>, e.g. dae86e1950b1277e545cee180551750029cfe735, dae86e ``` 完整的SHA-1對象名稱（40字節十六進制字符串），或存儲庫中唯一的前導子字符串。例如。如果存儲庫中沒有其他對象以dae86e開頭的對象，則dae86e1950b1277e545cee180551750029cfe735和dae86e都命名相同的提交對象。 ``` <describeOutput>, e.g. v1.7.4.2-679-g3bee7fb ``` `git describe`的輸出;即，最接近的標簽，可選地后跟破折號和多次提交，然后是破折號， _g_ 和縮寫的對象名稱。 ``` <refname>, e.g. master, heads/master, refs/heads/master ``` 一個象征性的引用名稱。例如。 _master_ 通常表示 _refs / heads / master_ 引用的提交對象。如果您碰巧同時擁有_磁頭/主控_和_標簽/主控_，您可以明確地說_磁頭/主控_告訴Git您的意思。當含糊不清時，_< refname>_ 通過以下規則中的第一場比賽消除歧義： 1. 如果 _$ GIT_DIR /< refname>_ 存在，這就是你的意思（這通常只適用于`HEAD`，`FETCH_HEAD`，`ORIG_HEAD`，`MERGE_HEAD`和`CHERRY_PICK_HEAD`）; 2. 否則， _refs /< refname>_ 如果存在; 3. 否則， _refs / tags /< refname>_ 如果存在; 4. 否則， _refs / heads /< refname>_ 如果存在; 5. 否則， _refs / remotes /< refname>_ 如果存在; 6. 否則， _refs / remotes /< refname> / HEAD_ （如果存在）。 `HEAD`命名您基于工作樹中的更改的提交。 `FETCH_HEAD`記錄您使用上次`git fetch`調用從遠程存儲庫中獲取的分支。 `ORIG_HEAD`是由以大刀闊斧的方式移動`HEAD`的命令創建的，用于在操作之前記錄`HEAD`的位置，以便您可以輕松地將分支的尖端更改回運行它們之前的狀態。 `MERGE_HEAD`在運行`git merge`時記錄您要合并到分支中的提交。當您運行`git cherry-pick`時，`CHERRY_PICK_HEAD`會記錄您正在挑選的提交。請注意，上述任何 _refs / *_ 情況可能來自 _$ GIT_DIR / refs_ 目錄或來自 _$ GIT_DIR / packed-refs_ 文件。雖然未指定引用名稱編碼，但首選UTF-8，因為某些輸出處理可能會假定使用UTF-8中的引用名稱。 ``` @ ``` 單獨 _@_ 是`HEAD`的捷徑。 ``` <refname>@{<date>}, e.g. master@{yesterday}, HEAD@{5 minutes ago} ``` 引用后跟 _@_ 后綴為日期規格括號對（例如 _{昨天}_ ， _{1個月2周3天1小時1秒前}_ 或 _{1979-02-26 18:30:00}_ ）指定先前時間點的ref值。此后綴只能在引用名稱后立即使用，并且引用必須具有現有日志（ _$ GIT_DIR / logs /< ref>_ ）。請注意，這會在給定時間查找**本地** ref的狀態;例如，上周本地_主_分支機構的內容。如果要查看在特定時間內提交的提交，請參閱`--since`和`--until`。 ``` <refname>@{<n>}, e.g. master@{1} ``` 后綴為 _@_ 的后綴為括號對中的序數規范（例如 _{1}_ ， _{15}_ ）指定第n個先驗那個參考的價值。例如 _master @ {1}_ 是 _master_ 的前一個值，而 _master @ {5}_ 是 _master_ 的第5個先前值]。此后綴只能在引用名稱后立即使用，并且引用必須具有現有日志（ _$ GIT_DIR / logs /< refname>_ ）。 ``` @{<n>}, e.g. @{1} ``` 您可以使用帶有空參考部分的 _@_ 構造來獲取當前分支的reflog條目。例如，如果你在分支 _blabla_ ，那么 _@ {1}_ 意味著與 _blabla @ {1}_ 相同。 ``` @{-<n>}, e.g. @{-1} ``` 構造 _@ { - < n>}_ 表示在當前分支/提交之前檢出的第n個分支/提交。 ``` <branchname>@{upstream}, e.g. master@{upstream}, @{u} ``` 后綴 _@ {upstream}_ 到分支機構（簡稱_< branchname> @ {u}_ ）指的是由branchname指定的分支設置為在其上構建的分支（配置為`branch.<name>.remote`和`branch.<name>.merge`）。缺少的branchname默認為當前的。當拼寫為大寫時，這些后綴也被接受，無論如何它們都意味著相同的東西。 ``` <branchname>@{push}, e.g. master@{push}, @{push} ``` 后綴 _@ {push}_ 報告分支“我們將推送到哪里”如果`branchname`在`branchname`被檢出時運行（或者當前`HEAD`如果沒有指定分支機構）。由于我們的推送目的地位于遠程存儲庫中，當然，我們報告與該分支對應的本地跟蹤分支（即 _refs / remotes /_ 中的內容）。這是一個讓它更清晰的例子： ``` $ git config push.default current $ git config remote.pushdefault myfork $ git checkout -b mybranch origin/master $ git rev-parse --symbolic-full-name @{upstream} refs/remotes/origin/master $ git rev-parse --symbolic-full-name @{push} refs/remotes/myfork/mybranch ``` 請注意，在我們設置三角形工作流程的示例中，我們從一個位置拉出并推送到另一個位置。在非三角形工作流程中， _@ {push}_ 與 _@ {upstream}_ 相同，并且不需要它。拼寫為大寫時也接受此后綴，無論情況如何都是相同的。 ``` <rev>^, e.g. HEAD^, v1.5.1^0 ``` 修訂參數的后綴 _^_ 表示該提交對象的第一個父級。 _^< n>_ 表示第n個親本（即_< rev> ^_ 等同于_< rev> ^_ ）。作為特殊規則，_< rev> ^ 0_ 表示提交本身并且在_< rev>時使用。_ 是引用提交對象的標記對象的對象名稱。 ``` <rev>~<n>, e.g. master~3 ``` 后綴_?< n>_ 到版本參數意味著提交對象是指定提交對象的第n代祖先，僅跟隨第一個父對象。即_< rev>?_相當于_< rev> ^^^_ ，其相當于_< rev> ^ 1 ^ 1 ^_ 。請參閱下文，了解此表單的用法。 ``` <rev>^{<type>}, e.g. v0.99.8^{commit} ``` 后綴 _^_ 后跟括號對中包含的對象類型名稱意味著在_< rev>處取消引用對象。_ 遞歸地直到_< type>類型的對象為止。找到_或者不再解除引用對象（在這種情況下，barf）。例如，如果_< rev>_ 是commit-ish，_< rev> ^ {commit}_ 描述了相應的提交對象。類似地，如果_< rev>_ 是樹，_< rev> ^ {tree}_ 描述了相應的樹對象。 _< rev> ^ 0_ 是_< rev> ^ {commit}_ 的簡寫。 _rev ^ {object}_ 可以用來確保 _rev_ 命名一個存在的對象，而不需要 _rev_ 作為標簽，并且不需要解除引用 _rev_ ;因為標簽已經是一個對象，所以即使一次到達一個對象也不需要解除引用。 _rev ^ {tag}_ 可用于確保 _rev_ 標識現有標記對象。 ``` <rev>^{}, e.g. v0.99.8^{} ``` 后綴 _^_ 后跟空括號對意味著該對象可以是標記，并遞歸取消引用標記，直到找到非標記對象。 ``` <rev>^{/<text>}, e.g. HEAD^{/fix nasty bug} ``` 后綴 _^_ 到一個修訂參數，后跟一個括號對，其中包含一個由斜杠引導的文本，與下面的_：/ fix討厭錯誤_語法相同，只是它返回可以從_< rev>到達的最年輕的匹配提交 _^_ 之前的_。 ``` :/<text>, e.g. :/fix nasty bug ``` 冒號后跟一個斜杠，后跟一個文本，命名一個提交，其提交消息與指定的正則表達式匹配。此名稱返回可從任何ref訪問的最新匹配提交，包括HEAD。正則表達式可以匹配提交消息的任何部分。為了匹配以字符串開頭的消息，可以使用例如_：/ ^ foo_ 。特殊序列_：/！_ 保留用于匹配的修飾符。 _：/！ - foo_ 執行負匹配，而_：/ !! foo_ 匹配文字_！_ 字符，然后是 _foo_ 。以_開頭的任何其他序列：/！_ 暫時保留。根據給定的文本，shell的單詞拆分規則可能需要額外的引用。 ``` <rev>:<path>, e.g. HEAD:README, :README, master:./README ``` 后綴_：_后跟一個路徑，命名由冒號前部分命名的樹形對象中給定路徑上的blob或樹。 _：path_ （在冒號前面有空部分）是下面描述的語法的特例：在給定路徑的索引中記錄的內容。以 _./_ 或 _../_ 開頭的路徑是相對于當前工作目錄的。給定路徑將轉換為相對于工作樹的根目錄。這對于從具有與工作樹具有相同樹結構的提交或樹來解決blob或樹最有用。 ``` :<n>:<path>, e.g. :0:README, :README ``` 冒號，可選地后跟一個階段號（0到3）和一個冒號，后跟一個路徑，在給定路徑的索引中命名一個blob對象。缺少的階段編號（以及其后面的冒號）命名階段0條目。在合并期間，階段1是共同的祖先，階段2是目標分支的版本（通常是當前分支），階段3是正在合并的分支的版本。以下是Jon Loeliger的插圖。提交節點B和C都是提交節點A的父節點。父提交從左到右排序。 ``` G H I J \ / \ / D E F \ | / \ \ | / | \|/ | B C \ / \ / A ``` ``` A = = A^0 B = A^ = A^1 = A~1 C = A^2 = A^2 D = A^^ = A^1^1 = A~2 E = B^2 = A^^2 F = B^3 = A^^3 G = A^^^ = A^1^1^1 = A~3 H = D^2 = B^^2 = A^^^2 = A~2^2 I = F^ = B^3^ = A^^3^ J = F^2 = B^3^2 = A^^3^2 ``` ## 指定范圍遍歷諸如`git log`之類的命令的歷史操作在一組提交上，而不僅僅是單個提交。對于這些命令，使用上一節中描述的表示法指定單個修訂版意味著來自給定提交的提交`reachable`集。提交的可達集是提交本身和其祖先鏈中的提交。 ### 提交排除 ``` ^<rev> (caret) Notation ``` 要排除從提交可到達的提交，使用前綴 _^_ 表示法。例如。 _^ r1 r2_ 表示從 _r2_ 可到達的提交，但排除可從 _r1_ （即 _r1_ 及其祖先）到達的提交。 ### 虛線范圍符號 ``` The .. (two-dot) Range Notation ``` _^ r1 r2_ 設置操作經常出現，因此有一個簡寫。如果你有兩個提交 _r1_ 和 _r2_ （根據上面的SPECIFYING REVISIONS中解釋的語法命名），你可以要求從r2可以訪問的提交，不包括那些可以從r1到達的提交 _^ r1 r2_ 可以寫成 _r1..r2_ 。 ``` The …? (three-dot) Symmetric Difference Notation ``` 類似的符號 _r1 ... r2_ 稱為 _r1_ 和 _r2_ 的對稱差異，定義為 _r1 r2 - not $（git merge） -base --all r1 r2）_。它是可以從 _r1_ （左側）或 _r2_ （右側）中的任何一個到達的提交集，但不是兩者都可以。在這兩個簡寫符號中，您可以省略一端并將其默認為HEAD。例如，_原點.._ 是 _origin..HEAD_ 的簡寫并詢問“自從我從原點分支分叉后我做了什么？”同樣， _.origin_ 是 _HEAD..origin_ 的簡寫，并詢問“自從我從它們分叉后，起源做了什么？”注意 _.._ 將意味著 _HEAD..HEAD_ ，這是一個空的范圍，既可以從HEAD到達又無法到達。 ### 其他< rev> ^父簡寫符號存在三個其他的縮寫，對于合并提交特別有用，用于命名由提交及其父提交形成的集合。 _r1 ^ @_ 符號表示 _r1_ 的所有親本。 _r1 ^！_ 表示法包含commit _r1_ 但不包括其所有父母。這個符號本身表示單個提交 _r1_ 。 _< rev> ^ - < n>_ 符號包括_< rev>_ 但不包括第n個親本（即_< rev> ^< n> ..< rev>_ 的簡寫），_< n>如果沒有給出，_ = 1。這通常對于合并提交很有用，您可以通過_< commit> ^ -_ 來獲取合并提交中合并的分支中的所有提交_< commit>_ （包括_< commit>_ 本身）。雖然_< rev> ^< n>_ 是關于指定單個提交父級，這三個符號也考慮其父級。例如你可以說 _HEAD ^ 2 ^ @_ ，但你不能說 _HEAD ^ @ ^ 2_ 。 ## 修訂范圍摘要 ``` <rev> ``` 包括可從< rev>到達的提交（即< rev>及其祖先）。 ``` ^<rev> ``` 排除可從< rev>到達的提交（即< rev>及其祖先）。 ``` <rev1>..<rev2> ``` 包括可從< rev2>到達的提交但不包括那些可以從< rev1>到達的那些。何時< rev1>或者< rev2>省略，默認為`HEAD`。 ``` <rev1>...<rev2> ``` 包括可從< rev1>到達的提交或者< rev2>但排除那兩個可以訪問的。何時< rev1>或者< rev2>省略，默認為`HEAD`。 ``` <rev>^@, e.g. HEAD^@ ``` 后綴為 _^_ 后跟at符號與列出_< rev>的所有父項相同。_ （意思是，包括從其父母可以訪問的任何內容，但不包括提交本身）。 ``` <rev>^!, e.g. HEAD^! ``` 后綴為 _^_ 后跟感嘆號與提交_< rev>相同。_ 然后它的所有父母都以 _^_ 為前綴來排除它們（以及它們的祖先）。 ``` <rev>^-<n>, e.g. HEAD^-, HEAD^-2 ``` 等同于_< rev> ^< n> ..< rev>_ ，_< n>如果沒有給出，_ = 1。以下是使用上面的Loeliger插圖的一些示例，其中注釋的擴展和選擇中的每個步驟都經過仔細說明： ``` Args Expanded arguments Selected commits D G H D D F G H I J D F ^G D H D ^D B E I J F B ^D B C E I J F B C C I J F C B..C = ^B C C B...C = B ^F C G H D E B C B^- = B^..B = ^B^1 B E I J F B C^@ = C^1 = F I J F B^@ = B^1 B^2 B^3 = D E F D G H E F I J C^! = C ^C^@ = C ^C^1 = C ^F C B^! = B ^B^@ = B ^B^1 ^B^2 ^B^3 = B ^D ^E ^F B F^! D = F ^I ^J D G H D F ``` ## PARSEOPT 在`--parseopt`模式下， _git rev-parse_ 幫助按摩選項為C腳本提供相同的設施。它作為一個選項規范化器（例如拆分單個開關聚合值），有點像`getopt(1)`。它采用標準輸入來解析和理解選項的規范，并在標準輸出上回顯適合`sh(1)` `eval`的字符串，用規范化的參數替換參數。如果出現錯誤，它會輸出標準錯誤流的使用情況，并以代碼129退出。注意：確保在將結果傳遞給`eval`時引用結果。請參閱下面的示例。 ### 輸入格式 _git rev-parse --parseopt_ 輸入格式是完全基于文本的。它有兩個部分，由僅包含`--`的線分隔。分隔符之前的行（應該是一個或多個）用于使用。分隔符后面的行描述了選項。每行選項都有這種格式： ``` <opt-spec><flags>*<arg-hint>? SP+ help LF ``` ``` <opt-spec> ``` 它的格式是短選項字符，然后用逗號分隔的長選項名稱。兩個部件都不是必需的，但至少需要一個部件。不得包含任何`<flags>`字符。 `h,help`，`dry-run`和`f`是正確的`<opt-spec>`的例子。 ``` <flags> ``` `<flags>`屬于`*`，`=`，`?`或`!`。 * 如果選項采用參數，請使用`=`。 * 使用`?`表示該選項采用可選參數。您可能希望使用`--stuck-long`模式能夠明確地解析可選參數。 * 使用`*`表示不應在為`-h`參數生成的用法中列出此選項。 [gitcli [7]](https://git-scm.com/docs/gitcli) 中記載的`--help-all`顯示了它。 * 使用`!`不會使相應的否定長選項可用。 ``` <arg-hint> ``` `<arg-hint>`（如果指定）用作幫助輸出中參數的名稱，用于帶參數的選項。 `<arg-hint>`由第一個空格終止。習慣上使用短劃線來分隔多字參數提示中的單詞。剝離空格后，該行的其余部分用作與選項關聯的幫助。空行被忽略，與此規范不匹配的行將用作選項組標題（使用空格開始行以有意創建此類行）。 ### 例 ``` OPTS_SPEC="\ some-command [<options>] <args>... some-command does foo and bar! -- h,help show the help foo some nifty option --foo bar= some cool option --bar with an argument baz=arg another cool option --baz with a named argument qux?path qux may take a path argument but has meaning by itself An option group Header C? option C with an optional argument" eval "$(echo "$OPTS_SPEC" | git rev-parse --parseopt -- "$@" || echo exit $?)" ``` ### 用法文字在上例中`"$@"`為`-h`或`--help`時，將顯示以下用法文本： ``` usage: some-command [<options>] <args>... some-command does foo and bar! -h, --help show the help --foo some nifty option --foo --bar ... some cool option --bar with an argument --baz <arg> another cool option --baz with a named argument --qux[=<path>] qux may take a path argument but has meaning by itself An option group Header -C[...] option C with an optional argument ``` ## SQ-QUOTE 在`--sq-quote`模式下， _git rev-parse_ 在標準輸出上回顯適合`sh(1)` `eval`的單行。該行是通過規范化`--sq-quote`之后的參數來完成的。除了引用參數之外別無其他。如果您希望在輸出引用shell之前 _git rev-parse_ 仍然按常規解釋命令輸入，請參閱`--sq`選項。 ### 例 ``` $ cat >your-git-script.sh <<\EOF #!/bin/sh args=$(git rev-parse --sq-quote "$@") # quote user-supplied arguments command="git frotz -n24 $args" # and use it inside a handcrafted # command line eval "$command" EOF $ sh your-git-script.sh "a b'c" ``` ## 例子 * 打印當前提交的對象名稱： ``` $ git rev-parse --verify HEAD ``` * 從$ REV shell變量中的修訂版打印提交對象名稱： ``` $ git rev-parse --verify $REV^{commit} ``` 如果$ REV為空或不是有效修訂，則會出錯。 * 與上面類似： ``` $ git rev-parse --default master --verify $REV ``` 但是如果$ REV為空，則將打印來自master的提交對象名稱。 ## GIT 部分 [git [1]](https://git-scm.com/docs/git) 套件