Go hash.Hash32 与 Hash64 的 Sum 方法为何仍返回字节切片

很多人第一次看到 hash.Hash32 或 hash.Hash64 时，会自然地期待 Sum() 返回 uint32 或 uint64。但 Go 的设计是：通用的 Sum 仍然返回字节切片，专用接口再额外提供 Sum32() 和 Sum64()。原因不在于哈希值算错了，而在于 Sum 继承的是所有哈希算法都能遵守的公共合同。

Hash、Hash32 与 Hash64 的接口分层

先看公共接口的职责。hash.Hash 继承了 io.Writer，同时规定 Sum(b []byte) []byte、Reset()、Size() 和 BlockSize()。其中 Sum 的语义不是“返回一个整数”，而是“把当前哈希追加到已有字节切片后返回结果”。这让调用方可以在摘要前面放入协议前缀，也让不同位宽的算法共享同一套调用方式。

Hash32 和 Hash64 都嵌入了 Hash。因此它们必须继续拥有 Sum，同时分别增加 Sum32() uint32 与 Sum64() uint64。一个接口负责通用的字节表示，另一个方法负责算法明确提供的整数表示，两者并不冲突。

Go 标准库统一设计所有哈希接口的Sum方法返回字节切片，是为了在保证Hash32、Hash64各自暴露单值强类型取值方法的前提下，让全量哈希实现都能无缝兼容依赖字节序列输出的通用序列化、拼接、摘要复用场景，避免拆分接口后出现大量重复适配逻辑。

Sum 的返回值为什么要保留为 []byte

哈希摘要最终要写入文件、协议字段、缓存键或日志时，本来就需要字节序列。若公共接口直接返回整数，不同算法的摘要长度、编码方式和前缀拼接都会变成调用方的额外分支。Sum(b) 还允许复用调用方提供的前缀切片；它只读取当前状态，不会因为取摘要而重置或继续写入。

下面的示例同时展示两种读取方式。fnv.New64a() 返回一个实现了 hash.Hash64 的哈希对象：协议字段使用 Sum，分桶或数值比较使用 Sum64。代码中的注释说明了前缀和状态边界。

package main

import (
    "encoding/binary"
    "fmt"
    "hash/fnv"
)

func main() {
    h := fnv.New64a()
    _, _ = h.Write([]byte("user:42")) // 写入待摘要的数据，错误可忽略是因为 hash.Hash 的 Write 不返回写入错误

    prefix := []byte("sha=")
    digest := h.Sum(prefix) // Sum 只追加当前摘要，不会改变 h 的内部状态
    number := h.Sum64()     // 需要整数时使用 Hash64 专门提供的数值方法

    var encoded [8]byte
    binary.BigEndian.PutUint64(encoded[:], number) // 需要固定协议字节序时显式编码

    fmt.Printf("%s%x\\n", digest[:4], digest[4:])
    fmt.Printf("number=%d encoded=%x\\n", number, encoded[:])
}

这里的 digest 以 sha= 开头，后面才是摘要字节；再次调用 h.Sum(nil) 仍能得到同一份当前摘要。若把 Sum 的结果转成字符串用于展示可以，但不要把字符串展示形式当作协议编码。需要整数时直接调用 Sum64，需要跨语言传输时再明确选择大端或小端。

按任务选择 Sum、Sum32 还是 Sum64

有一个容易忽略的边界：Sum 返回的是“追加后的切片”，不保证使用独立底层数组。若前缀切片的容量足够，返回值可能复用它的存储；如果需要保留原前缀，先复制一份。另一方面，Sum32 和 Sum64 只表达算法的整数摘要，不会替你决定网络字节序。

常见问题

调用 Sum 会不会让下一次 Write 失效？

不会。接口契约明确说明 Sum 不改变底层哈希状态，后续仍可继续写入。

为什么不把 []byte 强制转换成 uint64？

摘要的字节长度和编码方式属于算法与调用场景，公共接口不能假设所有哈希都适合一个整数；64 位实现应使用 Sum64。

Sum(nil) 与 Sum([]byte{}) 有区别吗？

两者都表示不提供前缀，常见结果是只得到摘要字节；真正需要拼接内容时传入已有切片即可。

判断这组 API 时可以记住一句话：Sum 是可组合的字节接口，Sum32 和 Sum64 是位宽明确的数值接口。按输出边界选择方法，比把一种结果强行转换成另一种更稳妥。

官方接口说明：https://pkg.go.dev/hash