在Git中树是什么意思?
我很困惑如何使用git archive
。
我有一个Git仓库文件夹Foo , Bar和Baz在顶层。 我需要以SVN-ISH方式导出文件夹Foo ,以进行快速testing部署。
我了解到,我可以用SVN-ISH导出方式使用git-archive
。
但是,这是事情, 以下工作正常:
git archive master | tar -x -C ~/destination
它会在目标文件夹中产生Foo , Bar , Baz文件夹。
但是,以下将 fatal not a valid object name
错误,而fatal not a valid object name
:
git archive master/foo | tar -x -C ~/destination
文档
看作为git archive
程序的概要,我看到它可以采取一个<tree-ish> [path]
作为参数(摘要汇总到相关的部分):
git archive <tree-ish> [path...]
如果 master/foo
不是 tree-ish
,那么是什么?
简答(TL; DR)
“Tree-ish”是一个术语,指的是最终导致(子)目录树(Git指向“树”和“树对象”目录)的任何标识符(在Git修订文档中指定)。
在原始海报的情况下, foo
是他想要指定的目录 。 在Git中指定(子)目录的正确方法是使用这个“tree-ish”语法( Git版本文档中的第15项):
<rev>:<path>
,例如HEAD:README
,:README
,master:./README
一个后缀
:
后跟一个path,在冒号之前的部分所指定的tree-ish对象的给定path中命名blob或tree。
所以换句话说, master:foo
是正确的语法,而不是master/foo
。
其他“Tree-ish”(Plus Commit-ish)
下面是一个完整的commit-ish和tree-ish标识符列表(来自Git修订文档 , 感谢LopSae指出它 ):
---------------------------------------------------------------------- | 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, :README, master:./README ---------------------------------------------------------------------- | Tree-ish? | Examples ---------------------------------------------------------------------- | 16. :<n>:<path> | :0:README, :README ----------------------------------------------------------------------
标识符#1-14都是“commit-ish”,因为它们全都导致提交,但是由于提交也指向目录树,它们最终都会导致(子)目录树对象,因此也可以用作“树-ish”。
当引用(子)目录时,#15也可以用作tree-ish,但它也可以用来标识特定的文件。 当它涉及到文件时,我不确定它是否仍然被认为是“树状”,或者更像是“blob-ish”(Git将文件称为“blob”)。
长的答案
在最底层,Git使用四个基本对象跟踪源代码:
- 带注释的标签,指向提交。
- 提交,指向您的项目的根目录树。
- 树,是目录和子目录。
- 斑点,这是文件。
每个对象都有自己的sha1哈希ID,因为Linus Torvalds将Gitdevise为内容可寻址的文件系统,也就是说文件可以根据内容(sha1 ID从文件内容生成)进行检索。 Pro Git书给出了这个示例图 :
许多Git命令可以接受提交和(子)目录树的特殊标识符:
-
“Commit-ish”是最终导致提交对象的标识符。 例如,
tag -> commit
-
“Tree-ish”是最终导致树(即目录)对象的标识符。
tag -> commit -> project-root-directory
因为commit对象总是指向一个目录树对象(你的项目的根目录),所以任何标识符“commit-ish”根据定义也是“tree-ish”。 换句话说, 导致提交对象的任何标识符也可以用来导致(子)目录树对象 。
但是由于目录树对象从未指向Git版本控制系统中的提交,因此不是每个指向(子)目录树的标识符都可以用来指向提交。 换句话说, “commit-ish”标识符集合是“tree-ish”标识符集合的严格子集。
正如文档中所解释的 ( 感谢Trebor帮我find它 ):
<tree>
指示树对象名称。
<commit>
指示提交对象名称。
<tree-ish>
指示树,提交或标记对象名称。 采用
<tree-ish>
参数的命令最终希望在<tree>
对象上运行,但是会自动解引用指向<tree>
<commit>
和<tag>
对象。<commit-ish>
指示提交或标记对象名称。 采用
<commit-ish>
参数的命令最终希望对<commit>
对象进行操作,但是会自动对<commit>
对象进行取消引用。
不能用作commit-ish的树形标识符集合是
-
<rev>:<path>
, 直接导致目录树,不提交对象。 例如,HEAD:subdirectory
。 -
目录树对象的Sha1标识符。
树是一种命名特定的树的方式,可以是以下之一:
- 参考资料如:
- 头
- 标签
- 分支名称
- 带有遥控器的分支名称,如
origin/somebranch
- 哈希
- 短哈希
最重要的是,上面的任何一个都可以加上^
, ~
。 引用还可以使用@{}
表示法来实现一些附加function:
-
HEAD^
或HEAD^1
将被parsing为HEAD的第一个父节点。 -
HEAD^2
将parsing为第二个父级 -
HEAD^3
将parsing为第三个父亲等,这是比较less见的产品, 并与章鱼策略合并 。 -
HEAD~
或HEAD~1
将parsing为头的第一个父母 -
HEAD~2
将parsing为HEAD~2
的第一个父项的第一个父项。 这将和HEAD^^
-
HEAD@{0}
将parsing为当前的HEAD -
HEAD@{1}
将parsing为前一个头。 这只能被引用使用,因为它使用了引用日志。 在HEAD
的情况下,每一次提交,合并,签出都会改变HEAD的值,并将其添加到日志中。git reflog HEAD
将显示引用日志,您可以在其中查看HEAD的所有移动,并正确地识别@{1}
等等将parsing为什么。
大部分上述内容可以进一步合并,只要它在你的仓库中是有意义的,例如: HEAD@{2}~3
somebranch^2~4
, c00e66e~4^2
, c00e66e~4^2
, anotherbranch~^~^~^
。
因此,上面描述的任何一个以及它们的组合,在文档中就是指tree-ish,它只是一种说明哪些树(或修订版)是应该用于大多数git命令的方法。
更多信息在修订select在Git书 。
你可能想要
git archive master foo | tar -x -C ~/destination
expression式master/foo
没有意义: master
是分支名称, foo
是目录名称,正如我所设想的那样。
编辑 :(删除断开的链接,见评论。)
有关<tree-ish>
和<commit-ish>
定义,请参阅git(1)手册页。 您必须search条款。 一般来说, <tree-ish>
表示对git树对象的引用,但是如果你传递了一个引用树的对象types(比如commit或branch),那么git会自动使用被引用的树。
我是一个新手来源控制和混帐。 这是我所知道的。 树是存储库中文件的结构。 它类似于文件系统中的目录。参见 – 哪个git工具生成了这个树视图?
树ish就像一棵树。 它引用树的一部分或提交。 您可以使用以下任何一种方法来引用提交:提交的全部或部分SHA-1哈希,HEAD指针,分支引用,标记引用。 另一种方法使用任何提及的方法以及提交的祖先或父母。 祖先的例子: