使用提交哈希将自述文件添加到'git archive'

Question

当向客户发布代码版本时，了解特定的提交代码副本将很有帮助。 'git archive'是否可能使生成的.zip文件包含readme.txt或其他指示符，该指示符显示使用的提交的哈希值？

我是git的新手，已经从Mercurial迁移了。 在Hg中，当生成存档时，该zip文件将包含hg_archive.txt，其中的哈希值会准确显示存档的生成位置。

谢谢

Answer 1

它已经在那里。 参见https://git-scm.com/docs/git-archive ：

在ZIP文件中，提交ID存储为文件注释。

Answer 2

您可以传递git archive一个文件名参数，您可以在其中包含短（或长）哈希作为文件名的一部分：

git archive -o "myrelease-$(git rev-parse --short HEAD).zip" HEAD

将给您一个文件名“ myrelease-f12cb0d.zip”

如果您想要更复杂的操作（例如添加自述文件），则可能需要创建一个bash脚本，该脚本既可以使用当前哈希值创建文件，又可以为您创建档案。

#!/bin/bash
git rev-parse --short HEAD > version.txt
tar . . .

Answer 3

我不认为有添加文件来描述它的本机方法，但是我也看不出如果认为它对您的项目很重要，为什么不自己手动进行处理。

通常不使用它，因为它在版本中有点多余（特别是在某种形式的语义版本中）。 版本号可能比最终使用者的提交哈希更具可读性和意义。 并且在Git中，您通常会使用标签标记版本，这些标签本身可用作指向某些提交的指针。

因此，拥有一个名为project-v0.1.2.tar.gz的档案足以找到提交（例如，在其他可能的命令中）：

$ git log -1 v0.1.2
0041db8e225cd1a8390509ceef3d162238983f94 (tag: v0.1.2) Commit description