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

Question

问题

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

堆栈溢出问题"What does tree-ish mean in git?" 交易 特别是树型，但我想了解更多关于两者的信息。

背景

文档中的用法

The Git documentation 多次提到“commit-ish”和 “树状”。例如，如果您正在检查the Git source code：

$ 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 文档defines what "commit-ish" and "tree-ish" are：

<tree>

表示树对象名称。

<commit>

表示提交对象名称。

<tree-ish>

表示树、提交或标记对象名称。采用<tree-ish> 的命令 参数最终想要对 <tree> 对象进行操作，但自动 取消引用指向 <tree> 的 <commit> 和 <tag> 对象。

<commit-ish>

表示提交或标记对象名称。采用<commit-ish> 的命令 参数最终想要对 <commit> 对象进行操作，但自动 取消引用指向 <commit> 的 <tag> 对象。

文档不够清晰

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

什么是“commit-ish”和“tree-ish”的具体例子，它们是如何 彼此不同？

Answer 1

简答 (TL;DR)

这里是 commit-ish 和 tree-ish 标识符的完整列表（来自 the Git revisions documentation）：

----------------------------------------------------------------------
|    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”，因为它们都导致提交，但是 因为提交也指向目录树，所以它们最终都会导致 （子）目录树对象，因此也可以用作“树形”。

#15 在引用（子）目录时也可以用作树形，但它 也可用于识别特定文件。当它提到文件时，我不是 确定它是否仍然被认为是“tree-ish”，或者更像是“blob-ish”（Git 将文件称为“blob”）。

长答案

Git 中的提交和目录树

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

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

每个对象都有自己的 sha1 哈希 ID，因为 Linus Torvalds 设计了 Git 就像 content- addressable 文件系统，即可以检索文件 基于它们的内容（sha1 ID 是从文件内容生成的）。专业的 Git 书给this example diagram：

Commit-ish vs Tree-ish

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

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

  tag -> commit

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

  tag -> commit -> project-root-directory

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

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

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

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

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

Answer 2

非英语母语 [原文如此！] 的人注意：“-ish”是一个后缀，可用于形容词以表示“具有类似”或“轻微”的品质 - 请参阅 http://chambers.co.uk/search/?query=ish&title=21st

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

例如“火星看起来像一颗微红色的星星”（“d”是双倍的！）； "盘子里的食物不是热的，而是温热的"

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