问题

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

堆栈溢出问题“ 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>指向的对象<commit>。

该文档不够清楚

即使上面的文档定义了“ commit-ish”和“ tree-ish”是什么，我仍然觉得它过于模糊和不清楚。

“ commit-ish”和“ tree-ish”的具体示例是什么，它们之间有何不同？

简短答案（TL; DR）

这是提交和树状标识符的完整列表（来自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引用（子）目录时，还可以用作树状目录，但也可以用于标识特定文件。当它指向文件时，我不确定它是否仍被视为“树状”或行为更像“斑点状”（Git将文件称为“斑点”）。

长答案

Git中的提交和目录树

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

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

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

承诺与树状

许多Git命令可以接受用于提交和（子）目录树的特殊标识符：

• “提交”是最终导致提交对象的标识符。例如，

  tag -> commit

• “树状”是最终导致树（即目录）对象的标识符。

  tag -> commit -> project-root-directory

因为提交对象总是指向目录树对象（项目的根目录），所以根据定义，“ commit-ish”的任何标识符也就是“ tree-ish”。换句话说，任何导致提交对象的标识符也可以用于导致（子）目录树对象。

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

不能用作提交树的树形标识符的集合是

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

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

非英语母语人士的注意事项：“ -ish”是后缀，可用于形容词，以表示“具有类似或类似的品质”-请参见http://chambers.co.uk / search /？query = ish＆title = 21st

因此，“ tree-ish”-就像“ tree” ....“ commit-ish”-像“ commit”

例如：“火星看起来像红星”（“ d”加倍！）；“盘子上的食物不热，但很热”

我认为这可以更好地解释“什么是……”，因为它可以解释语言的用法。