问题

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

堆栈溢出问题 "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 :



文档不够清楚

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

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

最佳答案

简答 (TL;DR)

这是一个完整的 commit-ish 和 tree-ish 标识符列表(来自 the Gitrevisions 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 状”(Git
将文件称为“blob”)。

长答案

Git 中的提交和目录树

在最底层,Git 使用四个基本的方法来跟踪源代码
对象:
  • 带注释的标签,指向提交。
  • Commits,指向你项目的根目录树。
  • 树,即目录和子目录。
  • Blob,即文件。

  • 这些对象中的每一个都有自己的 sha1 哈希 ID,因为 Linus Torvalds 设计了
    Git 就像一个 content- addressable 文件系统,即可以检索文件
    基于它们的内容(sha1 ID 是从文件内容生成的)。专业版 Git
    book 给出 this example diagram :

    git - Git 中的 commit-ish 和 tree-ish 是什么?-LMLPHP

    Commit-ish 与 Tree-ish

    许多 Git 命令可以接受提交和(子)目录的特殊标识符
    树木:
  • "Commit-ish"是最终导致提交对象的标识符。例如,
    tag -> commit
  • “Tree-ish”是最终导致树(即目录)对象的标识符。
    tag -> commit -> project-root-directory

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


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


    不能用作 commit-ish 的一组树状标识符是
  • <rev>:<path> ,这导致 直接 到目录树,不提交
    对象。例如, HEAD:subdirectory
  • 目录树 对象的 Sha1 标识符。
  • 关于git - Git 中的 commit-ish 和 tree-ish 是什么?,我们在Stack Overflow上找到一个类似的问题:https://stackoverflow.com/questions/23303549/

    10-13 06:36