什么是Git中的commit-ish和tree-ish?

问题

Git中commit-ish和tree-ish的具体示例是什么?

Stack Overflow问题"树在git中意味着什么?" 交易特别是树,但我想更多地了解两者。

背景

文档中的用法

Git文档对" commit-ish"进行了多次引用。 和"树肥胖型". 例如,如果您正在检查Git源代码:

$ git grep --files-with-matches --extended-regexp "commit(-)*ish"
config.txt
git-describe.txt
git-fast-import.txt
git-name-rev.txt
git-push.txt
git-rebase.txt
git-rev-parse.txt
git.txt
gitcli.txt
glossary-content.txt
howto/revert-branch-rebase.txt
revisions.txt

$ git grep --files-with-matches --extended-regexp "tree(-)*ish" | \
$ grep --invert-match RelNotes
diff-format.txt
diff-generate-patch.txt
git-archive.txt
git-cat-file.txt
git-checkout.txt
git-diff-index.txt
git-diff-tree.txt
git-ls-files.txt
git-ls-tree.txt
git-merge-tree.txt
git-read-tree.txt
git-reset.txt
git-svn.txt
git.txt
gitcli.txt
gittutorial-2.txt
glossary-content.txt
revisions.txt

定义

Git文档定义了什么" commit-ish" 和" tree-ish" 是:

<tree-ish>

表示树对象名称。

<tree-ish>

表示提交对象名称。

<tree-ish>

表示树,提交或标记对象名称。 采用<commit-ish>的命令   参数最终想要在<commit>对象上自动运行   dereferences <tag><commit>指向<tree>的对象。

<commit-ish>

表示提交或标记对象名称。 采用<commit-ish>的命令   参数最终想要在<commit>对象上自动运行   dereferences <tag>指向<commit>的对象。

文档不够清晰

即使上面的文档定义了什么&#34; commit-ish&#34; 和&#34; tree-ish&#34; 是,我仍觉得它太模糊不清楚了。

什么是&#34; commit-ish&#34;的具体例子。 和&#34; tree-ish&#34;,他们是怎样的彼此不同?

Community asked 2019-08-11T06:02:37Z
2个解决方案
126 votes

简答(TL; DR)

这里是commit-ish和tree-ish标识符的完整列表(来自Git修订文件):

----------------------------------------------------------------------
|    Commit-ish/Tree-ish    |                Examples
----------------------------------------------------------------------
|  1. <sha1>                | dae86e1950b1277e545cee180551750029cfe735
|  2. <describeOutput>      | v1.7.4.2-679-g3bee7fb
|  3. <refname>             | master, heads/master, refs/heads/master
|  4. <refname>@{<date>}    | master@{yesterday}, HEAD@{5 minutes ago}
|  5. <refname>@{<n>}       | master@{1}
|  6. @{<n>}                | @{1}
|  7. @{-<n>}               | @{-1}
|  8. <refname>@{upstream}  | master@{upstream}, @{u}
|  9. <rev>^                | HEAD^, v1.5.1^0
| 10. <rev>~<n>             | master~3
| 11. <rev>^{<type>}        | v0.99.8^{commit}
| 12. <rev>^{}              | v0.99.8^{}
| 13. <rev>^{/<text>}       | HEAD^{/fix nasty bug}
| 14. :/<text>              | :/fix nasty bug
----------------------------------------------------------------------
|       Tree-ish only       |                Examples
----------------------------------------------------------------------
| 15. <rev>:<path>          | HEAD:README.txt, master:sub-directory/
----------------------------------------------------------------------
|         Tree-ish?         |                Examples
----------------------------------------------------------------------
| 16. :<n>:<path>           | :0:README, :README
----------------------------------------------------------------------

标识符#1-14都是“commit-ish”,因为它们都会导致提交,但是因为提交也指向目录树,它们最终都会导致(子)目录树对象,因此也可以用作“tree-ish”。

当#15引用(子)目录时,它也可以用作tree-ish也可用于识别特定文件。 当它引用文件时,我不是确定它是否仍然被认为是“树木”,或者更像是“blob-ish”(Git将文件称为“blob”)。

长答案

在Git中提交和目录树

在最低级别,Git使用四个基本跟踪源代码对象:

  1. 带注释的标签,指向提交。
  2. 提交,指向项目的根目录树。
  3. 树,是目录和子目录。
  4. Blob,这是文件。

Linus Torvalds设计的每个对象都有自己的sha1哈希IDGit就像一个内容可寻址的文件系统,即可以检索文件基于其内容(sha1 ID是从文件内容生成的)。 Pro Git本书给出了这个示例图:

Figure 9-3 from Pro Git book

Commit-ish vs Tree-ish

许多Git命令可以接受提交和(子)目录的特殊标识符树:

  • “Commit-ish”是最终导致提交对象的标识符。 例如,

    <rev>:<path>

  • “Tree-ish”是最终导致树(即目录)对象的标识符。

    <rev>:<path>

因为提交对象始终指向目录树对象(根目录)你的项目的目录),任何“commit-ish”的标识符是,by定义,也是“tree-ish”。 换句话说,任何导致a的标识符commit对象也可用于引导(子)目录树对象。

但由于目录树对象从未指向Git版本控制中的提交系统,不是每个指向(子)目录树的标识符也可以用于指向提交。 换句话说,“commit-ish”标识符的集合是“tree-ish”标识符集的严格子集。

不能用作commit-ish的树形标识符集合

  1. <rev>:<path>,直接指向目录树,而不是提交对象。 例如,HEAD:subdirectory

  2. 目录树对象的Sha1标识符。

answered 2019-08-11T06:04:05Z
21 votes

请注意非母语英语[sic!]发言人:&#34; -ish&#34; 是一个后缀,可以应用于形容词,以表明&#34;具有像&#34; 或者&#34;略微&#34; - 见[http://chambers.co.uk/search/?query=ish&amp;title=21st]

因此&#34; tree-ish&#34; - 像一棵树&#34; ....&#34; commit-ish&#34; - 像一个&#34;提交&#34;

例如&#34;火星看起来像一颗红色的星星&#34; (&#34; d&#34;加倍!); &#34;盘子里的食物不热,但是温暖的#34;

我相信这有助于解释&#34;什么是......&#34; 更好的是,它解释了语言的用法。

MikeW answered 2019-08-11T06:04:53Z
translate from https://stackoverflow.com:/questions/23303549/what-are-commit-ish-and-tree-ish-in-git