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

Question

问题

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

Stack Overflow问题"What does tree-ish mean in git?"处理 特别是tree-ish，但我想更多地了解 两者 。

背景

文档中的用法

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>对象进行操作，但是会自动进行   取消引用指向<commit>的{​​{1}}和<tag>个对象。

<tree>

     

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

文档不够清晰

即使上面的文档定义了“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都是＆＃34; commit-ish＆＃34;，因为它们都会导致提交，但是 因为提交也指向目录树，它们最终都会导致 （子）目录树对象，因此也可以用作＆＃34; tree-ish＆＃34;。

＃15在引用（子）目录时也可以用作tree-ish，但它 也可用于识别特定文件。当它引用文件时，我不是 确定它是否仍被视为＆＃34; tree-ish＆＃34;，或者如果行为更像是＆＃34; blob-ish＆＃34; （GIT 将文件称为＆＃34; blobs＆＃34;）。

长答案

在Git中提交和目录树

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

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

自Linus Torvalds设计以来，每个对象都有自己的sha1哈希ID Git就像一个content- addressable文件系统，即可以检索文件 基于其内容（sha1 ID是从文件内容生成的）。 Pro Git 本书给出this example diagram：



Commit-ish vs Tree-ish

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

• ＆＃34;提交肥胖型＆＃34;是最终导致提交对象的标识符。例如，

  tag -> commit

• ＆＃34;树肥胖型＆＃34;是最终导致树（即目录）对象的标识符。

  tag -> commit -> project-root-directory

因为提交对象始终指向目录树对象（根目录） 你项目的目录），任何标识符是＆＃34; commit-ish＆＃34;是的，是 定义，也＆＃34; tree-ish＆＃34;。换句话说， 任何导致a的标识符 commit对象也可用于指向（子）目录树对象 。

但是由于目录树对象从未指向Git的版本控制中的提交 系统，不是每个指向（子）目录树的标识符也可以 用于指向提交。换句话说，＆＃34; commit-ish＆＃34;身份标识 是＆＃34; tree-ish＆＃34;的一组严格的子集。标识符

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

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

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

Answer 2

请注意非英语[sic！]发言人：“-ish”是一个后缀，可以应用于形容词以表示“具有类似”或“略有”的质量 - 请参阅http://chambers.co.uk/search/?query=ish&title=21st < / p>

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

例如“火星看起来像一颗红色的星星”（“d”加倍！）; “盘子里的食物不热，但很温暖”

我认为这有助于更好地解释“什么是......”，因为它解释了语言的用法。