我对如何使用非常困惑git archive。

我有一个git仓库，在顶层有Foo，Bar和Baz文件夹 。我需要以一种类似于SVN的方式导出文件夹Foo，以进行快速测试部署。

我才知道，我可以用git-archive在SVN-ISH出口排序的方式。

但是，事情就这样了，以下工作正常：

git archive master | tar -x -C ~/destination

结果是目标文件夹中的Foo，Bar，Baz文件夹。

然而，下面就会因错误使用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）

“树状”是指最终导致（子）目录树（Git将目录称为“树”和“树对象”）的任何标识符（如Git修订版文档中所指定）。

在原始发布者的情况下，foo 是他要指定的目录。在Git中指定（子）目录的正确方法是使用此“树状”语法（Git修订文档中的项目＃15 ）：

<rev>:<path>例如HEAD:README，:README，master:./README

在后缀:后跟路径的名称是树状对象中给定路径上的斑点或树的名称，该对象由冒号前的部分命名。

换句话说，master:foo正确的语法不是master/foo。

其他“树状”（加上提交状）

这是提交和树状标识符的完整列表（来自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”，因为它们都导致提交，但是由于提交也指向目录树，因此它们最终都导致（子）目录树对象，因此也可以用作“ tree” -ish”。

＃15引用（子）目录时，还可以用作树状目录，但也可以用于标识特定文件。当它指向文件时，我不确定它是否仍被视为“树状”或行为更像“斑点状”（Git将文件称为“斑点”）。

长答案

在最低层次上，Git使用四个基本对象跟踪源代码：

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

这些对象中的每一个都有其自己的sha1哈希ID，因为Linus Torvalds将Git设计为可寻址内容的文件系统，即可以根据文件的内容来检索文件（sha1 ID是从文件内容生成的）。Pro Git书给出了以下示例图：

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

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

  tag -> commit

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

  tag -> commit -> project-root-directory

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

但是由于目录树对象从不指向Git版本管理系统中的提交，因此并非每个指向（子）目录树的标识符都可以用于指向提交。换句话说，“ commit-ish”标识符集合是“ tree-ish”标识符集合的严格子集。

如文档中所述（感谢Trebor帮助我找到它）：

<tree>

指示树对象名称。

<commit>

指示提交对象名称。

<tree-ish>

指示树，提交或标记对象名称。带有<tree-ish> 参数的命令最终希望对一个<tree>对象进行操作，但是会自动取消引用<commit>和<tag>指向的对象<tree>。

<commit-ish>

指示提交或标记对象名称。带有<commit-ish> 参数的命令最终希望对一个<commit>对象进行操作，但会自动取消引用<tag>指向的对象<commit>。

不能用作提交树的树形标识符的集合是

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

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

树状树是命名特定树的一种方式，可以是以下之一：

• 引用如下：
  • 头
  • 标签
  • 分行名称
  • 带有遥控器的分支名称，例如 origin/somebranch
• 杂凑
• 短哈希

最重要的是，以上任何内容都可以添加^，~。引用也可以将@{}符号用于某些其他功能：

• HEAD^或HEAD^1将解析为HEAD的第一个父级。
• HEAD^2 将解决第二个父母
• HEAD^3将解析为第三个父级，依此类推，这种情况较为罕见，并且是与章鱼策略合并的产物 。
• HEAD~或HEAD~1将解析为head的第一个父项
• HEAD~2将解析为HEAD的第一个父级的第一个父级。这将与HEAD^^
• HEAD@{0} 将解析为当前的HEAD
• HEAD@{1}将解析为前一个头。这只能由参考使用，因为它利用了参考日志。对于HEAD每次提交，合并，签出都会更改HEAD的值，并将其添加到日志中。git reflog HEAD将显示参考日志，您可以在其中查看HEAD的所有运动，并正确地@{1}解决了诸如此类的问题。

上述大部分可以进一步结合，只要它是有道理的在你的仓库，例如：HEAD@{2}~3，somebranch^2~4，c00e66e~4^2，anotherbranch~^~^~^。

因此，上述任何内容及其组合，在文档中都以树状表示，这只是一种方式，它说明什么树（或修订版）是大多数git命令都应使用的树。

有关更多信息，请参见Git书中的“版本选择”。

你可能想要

git archive master foo | tar -x -C ~/destination

该表达式master/foo没有意义：master是分支名称，并且foo我认为目录名称。

编辑：（已删除断开的链接。请参阅注释。）

对于定义<tree-ish>和<commit-ish>看到的git（1）手册页。您必须搜索条款。通常，它<tree-ish>是指对git树对象的引用，但是如果您传递引用树的对象类型（例如，提交或分支），则git将自动使用引用的树。

我是源代码控制和git的新手。这就是我所知道的。树是存储库中文件的结构。它类似于文件系统中的目录。请参阅- 哪个git工具生成了此树形视图？

树状意味着像一棵树。它引用树的一部分或提交。您可以使用以下任意一种引用提交：提交的SHA-1散列的全部或一部分，HEAD指针，分支引用，标签引用。另一种方法将上述方法中的任何一种与提交的祖先或父母一起使用。祖先的例子：

从Git词汇表来看，树状含义是“树对象或可以递归引用到树对象的对象”。commit，HEAD和tag是树状对象的示例。