Git中的commit和ish是什么?

问题

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

堆栈溢出问题“tree-ish在git中意味着什么? 专门处理tree-ish,但我想更多地了解这两者

背景

用于文档

Git文档对“commit-ish”和“tree-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> 

指示树对象名称。

 <commit> 

指示提交对象名称。

 <tree-ish> 

指示树,提交或标记对象名称。 采用<tree-ish>参数的命令最终希望在<tree>对象上运行,但是会自动解引用指向<tree> <commit><tag>对象。

 <commit-ish> 

指示提交或标记对象名称。 采用<commit-ish>参数的命令最终希望对<commit>对象进行操作,但是会自动对<commit>对象进行取消引用。

文档不够清楚

尽pipe上面的文档定义了什么是“承诺”和“树”,我仍然觉得它太模糊,不清楚。

“承诺”和“树”的具体例子是什么,它们又有什么不同呢?

简答(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”,因为它们全都导致提交,但是由于提交也指向目录树,它们最终都会导致(子)目录树对象,因此也可以用作“树-ish”。

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

长的答案

提交和目录树在Git中

在最底层,Git使用四个基本对象跟踪源代码:

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

每个对象都有自己的sha1哈希ID,因为Linus Torvalds将Gitdevise为内容可寻址的文件系统,也就是说文件可以根据内容(sha1 ID从文件内容生成)进行检索。 Pro Git书给出了这个示例图 :

Pro Git书中的图9-3

提交与树 – ish

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

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

    tag -> commit

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

    tag -> commit -> project-root-directory

因为commit对象总是指向一个目录树对象(你的项目的根目录),所以任何标识符“commit-ish”根据定义也是“tree-ish”。 换句话说, 导致提交对象的任何标识符也可以用来导致(子)目录树对象

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

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

  1. <rev>:<path>直接导致目录树,不提交对象。 例如, HEAD:subdirectory

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

请注意非英语母语人士:“-ish”是可应用于形容词的后缀,用于表示“具有类似性质”或“略微” – 请参阅http://chambers.co.uk /search/?查询= ISH&标题= 21

因此,“树” – 就像一棵“树”……“承诺” – 就像一个“承诺”

例如“火星看起来像一颗红色的星星”(“d”翻倍! “盘子里的食物不热,但温暖”

我相信这有助于解释“什么是…”更好,因为它解释了语言的使用。