Go crypto/sha256.New224 怎样理解 28 字节摘要和 Sum 追加语义

我第一次把 SHA-224 接进 Go 代码时，真正容易混淆的不是算法名，而是三个结果形状：New224() 返回的是 hash.Hash，摘要固定为 28 字节；Sum 会把摘要追加到传入切片；如果输入已经完整放在一个 []byte 里，还可以直接用 Sum224 得到固定长度数组。

官方地址：https://pkg.go.dev/crypto/sha256#New224

这篇只解决 SHA-224 的调用和输出边界，不讨论密码协议设计，也不把输出长度差异写成安全强度结论。

记住一句话：New224 负责增量写入，Sum(nil) 取出 28 字节摘要，Sum224(data) 适合一次性输入；hash.Hash.Sum 不会覆盖前缀，也不会重置哈希对象。

先确认 28 字节从哪里来

crypto/sha256 同时实现 SHA-224 和 SHA-256。官方文档把 Size224 定义为 28，把 Size 定义为 32。于是 New224 得到的对象仍然遵循 hash.Hash 接口，但它的 Size() 结果对应 SHA-224 的 28 字节。

分段输入时，我会把对象当作一个持续接收字节的摘要器。下面的写法适合数据来自多个读取块的场景：

package main

import (
	"crypto/sha256"
	"fmt"
)

func main() {
	// New224 返回支持增量 Write 的 SHA-224 摘要对象。
	h := sha256.New224()
	parts := [][]byte{[]byte("go "), []byte("sha224")}
	for _, part := range parts {
		// hash.Hash.Write 的错误通常为 nil，但保留检查能让替换输入源时更安全。
		if _, err := h.Write(part); err != nil {
			panic(err)
		}
	}

	// Sum(nil) 取出摘要，不会清空 h，也不会改变已写入的数据。
	digest := h.Sum(nil)
	fmt.Printf("bytes=%d hex=%x\n", len(digest), digest)
}

这里打印的 len(digest) 应该是 28。需要保存二进制摘要时直接保留 []byte；需要日志或文本协议时再用 %x 转成十六进制字符串。十六进制只是展示编码，字符数会是字节数的两倍，不代表摘要本身变成了 56 字节。

看懂 Sum 的追加语义，再选择 Sum224

我更容易踩到的坑是把 h.Sum(buf) 当成“把摘要写入 buf 的前 28 个位置”。hash.Hash.Sum 的语义是把当前摘要追加到 b 后面，并返回扩展后的切片。因此传入带内容的切片时，前缀会保留：

package main

import (
	"crypto/sha256"
	"fmt"
)

func main() {
	// 先写入完整输入，后续两次 Sum 都只读取当前摘要。
	h := sha256.New224()
	if _, err := h.Write([]byte("go sha224")); err != nil {
		panic(err)
	}

	// Sum 会追加到 prefix，不会覆盖 prefix，也不会重置 h。
	prefix := []byte("id=")
	withPrefix := h.Sum(prefix)
	withoutPrefix := h.Sum(nil)
	fmt.Printf("prefix=%q total=%d digest=%x\n", prefix, len(withPrefix), withoutPrefix)
}

这个例子还说明了第二个边界：调用 Sum 不等于“取完一次就结束”。如果后面继续 Write，对象仍会在原有状态上继续累计。要开始一份完全独立的摘要，应创建新的 New224 对象，而不是期待 Sum 自动清零。

当输入已经完整存在内存中，一次性 API 更直观：

package main

import (
	"crypto/sha256"
	"fmt"
)

func main() {
	data := []byte("go sha224")
	// Sum224 直接返回 [Size224]byte，尺寸在类型上就是 28 字节。
	digest := sha256.Sum224(data)
	// %x 只负责把固定数组转为可读的十六进制文本。
	fmt.Printf("bytes=%d hex=%x\n", len(digest), digest)
}

Sum224 返回的是 [sha256.Size224]byte，不是可变长度切片。传给需要 []byte 的函数时可以写成 digest[:]；若要拼接到已有切片，则先显式转换，避免把数组和切片混为一谈。

三个容易误读的边界

• 不要把摘要长度和十六进制长度混在一起。 二进制摘要是 28 字节，十六进制文本通常是 56 个 ASCII 字符。
• 不要把 Sum 当成 Reset。 它只读取当前摘要并追加到目标切片；需要新摘要时重新创建对象，或在明确理解接口语义后使用新的生命周期。
• 不要为了完整输入强行使用增量对象。 单个字节切片用 Sum224 更能表达“输入一次、得到固定数组”的意图；流式读取则使用 New224 和 Write。

小结：按输入形态选择 API

相关问题

为什么 New224 返回接口而不是 [28]byte？

因为 New224 面向增量输入，调用方可以多次 Write，并通过 hash.Hash 统一处理不同摘要实现；完整输入的固定数组需求则由 Sum224 表达。

Sum(nil) 和 Sum([]byte("id=")) 的摘要一样吗？

追加进去的 28 字节摘要相同，但返回切片的前缀不同。前者只有摘要，后者包含原有的 id= 和摘要；两者都不会重置哈希对象。