简短回答(TL;DR)
这是提交式和树式标识符的完整列表(来自吉特
修订文档):
----------------------------------------------------------------------
| 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 当引用(子)目录时也可以用作树形目录,但它
也可用于识别特定文件。当它提到文件时,我不是
确定它是否仍然被认为是“tree-ish”,或者是否更像“blob-ish”(Git
将文件称为“blob”)。
长答案
Git 中的提交和目录树
在最低级别,Git 使用四个基本功能来跟踪源代码
对象:
- 带注释的标签,指向提交。
- 提交,它指向项目的根目录树。
- 树,是目录和子目录。
- Blob,即文件。
每个对象都有自己的 sha1 哈希 ID,因为 Linus Torvalds 设计了
Git 就像内容可寻址文件系统,即可以检索文件
基于其内容(sha1 ID 由文件内容生成)。专业 Git
书给了这个示例图:
提交式 vs 树式
许多 Git 命令可以接受提交和(子)目录的特殊标识符
树木:
-
“Commit-ish”是最终导致提交对象的标识符。例如,
tag -> commit
-
“Tree-ish”是最终导致树(即目录)对象的标识符。
tag -> commit -> project-root-directory
因为提交对象总是指向目录树对象(根
项目的目录),任何“commit-ish”的标识符都是
定义,也“树状”。换句话说,任何导致的标识符
commit 对象也可用于指向(子)目录树对象.
但由于目录树对象从不指向 Git 版本控制中的提交
系统中,并非每个指向(子)目录树的标识符都可以
用于指向提交。换句话说,一组“commit-ish”标识符
是“树状”标识符集的严格子集。
树状标识符的集合不能用作 commit-ish are
<rev>:<path>
, 这导致directly到目录树,而不是提交
对象。例如,HEAD:subdirectory
.
Sha1 标识符目录树对象。