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

Question

问题

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

Stack Overflow问题"git中树是什么意思？" 特别是涉及树,但我想更多地了解这两者.

背景

文档中的用法

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>对象,但自动取消引用<commit>和<tag>指向在对象<tree>.

<commit-ish>

表示提交或标记对象名称.接受<commit-ish> 参数的命令最终希望对某个<commit>对象进行操作,但会自动取消引用<tag>指向a的对象<commit>.

文档不够清晰

尽管上面的文档定义了"commit-ish"和"tree-ish"是什么,但我仍然发现它过于模糊和不清楚.

什么是"commit-ish"和"tree-ish"的具体示例,它们如何彼此不同？

Answer 1

简答(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. Blob,这是文件.

这些对象中的每一个都有自己的sha1哈希ID,因为Linus Torvalds将Git设计为内容可寻址文件系统,即可以根据文件内容检索文件(sha1 ID是从文件内容生成的).Pro Git书给出了这个示例图:

Commit-ish vs Tree-ish

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

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

  tag -> commit

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

  tag -> commit -> project-root-directory

由于提交对象始终指向目录树对象(项目的根目录),因此根据定义,任何"commit-ish"标识符也是"tree-ish".换句话说,任何指向提交对象的标识符也可用于指向(子)目录树对象.

但由于目录树对象从未指向Git版本控制系统中的提交,因此并非每个指向(子)目录树的标识符也可用于指向提交.换句话说,"commit-ish"标识符集是"tree-ish"标识符集的严格子集.

该集树十岁上下的标识符是为提交十岁上下不能使用的

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

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

Answer 2

非本地英语[sic!]发音者的注意事项:"-ish"是一个后缀,可以应用于形容词以表示"具有类似"或"稍微"的质量 - 请参阅http://chambers.co.uk /搜索/？查询= ISH&标题= 21

因此"tree-ish" - 就像"树"......"commit-ish" - 就像"提交"

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

我相信这有助于更好地解释"什么是......",因为它解释了语言的用法.