Git SHA-1哈希构建：提交与附注标签的差异及实现疑问

已实现的Commit哈希生成 #

我已成功实现基于数据拼接的Git Commit SHA-1哈希生成，通过调用SHA-1算法处理tree、author、committer等信息，生成的哈希与Git官方输出完全一致。Commit的哈希拼接格式如下：

tree ***
parent ***
author *** *** ***
committer *** *** ***
gpgsig ***

***

（注：***代表实际输入内容）

附注标签哈希生成的问题 #

目前尝试为Annotated Tags实现相同的哈希构建逻辑，但始终无法得到与Git一致的SHA-1结果。已发现的明显差异：

• 消息内容位于PGP签名之前
• PGP签名没有gpgsig 前缀

我尝试了多种换行组合仍未成功，当前推测的格式如下：

object ***
type ***
tag ***
tagger *** *** ***

***
***

疑问解答 #

1. 附注标签的哈希生成还有哪些差异？格式假设是否错误？ #

你的格式框架基本正确，但有几个关键细节需要修正：

• 仅Commit对象的gpgsig带有空格前缀，Annotated Tag的PGP签名不需要该前缀
• 签名内容的换行和缩进必须严格匹配Git的处理规则：签名的每一行（除了第一行）都需要以4个空格缩进
• 消息和签名之间的空行必须严格保留，同时消息本身的换行要完全和原始tag一致

正确的Annotated Tag哈希拼接格式示例：

object 7a9f370c167a82182464a2a9d5b38203a9b87844
type commit
tag v1.0.0
tagger John Doe <john@example.com> 1620000000 +0800

Release version 1.0.0
-----BEGIN PGP SIGNATURE-----
    iQIzBAABCgAdFiEE...
    ...
    8Q8f9X7kZ
-----END PGP SIGNATURE-----

2. git cat-file的输出是否等同于哈希拼接的依据？ #

是的，但需要区分不同参数的输出：

• git cat-file -p <tag哈希>会格式化显示内容（比如把时间戳转为易读格式），不完全等同于哈希计算的原始数据
• git cat-file blob <tag哈希>会输出Git内部存储的原始字节流，这才是哈希计算的直接依据

Commit场景下git cat-file -p能匹配是因为Commit的时间戳格式在显示和原始存储中差异不影响哈希，但Tag的签名缩进等细节必须以原始字节流为准。

3. Git开源代码中SHA-1哈希构建的相关实现 #

Git中负责对象哈希计算的核心逻辑在object.c文件中，处理Annotated Tag的关键部分在write_tag和hash_object函数中：

1. 先拼接对象头部：tag <内容长度>\0（长度为后续Tag内容的字节数）
2. 按固定顺序拼接Tag的具体内容：object、type、tag、tagger字段，空行，消息内容，签名内容
3. 对拼接后的完整字节流计算SHA-1哈希

补充说明 #

仅在Commit对象中，gpgsig字段带有空格前缀；Annotated Tag的签名不需要该前缀。

内容的提问来源于stack exchange，提问作者Ron Germano