Go sha512.Hash.Sum 怎么把摘要追加到已有字节前缀

把 SHA-512 摘要接在已有字节前缀后面，直接接住 out := h.Sum(prefix) 的返回值即可。前缀不是哈希输入，也不会被摘要覆盖；真正参与计算的数据由 h.Write(message) 提供。完整结果包含前缀和 64 字节摘要，不能只看原变量 prefix 的长度。

官方文档：https://pkg.go.dev/hash#Hash；SHA-512 包：https://pkg.go.dev/crypto/sha512。

给编码缓冲区追加摘要，先分清两种输入

考虑一个原创协议编码场景：message 是消息内容，prefix 是报文中的类型字节。需求是保留类型字节，在它后面附上消息摘要。这是缓冲区拼装问题，不是新算法或已证实的行业趋势；标准库的接口足以表达它，不需要先转成字符串再拼回来。

sha512.New() 返回实现 hash.Hash 的对象 h。message 与 h 的关系是输入数据；prefix 与 Sum 的关系是结果前缀。Sum 读取当前摘要而不改变 h 的哈希状态，prefix 不会因为出现在 Sum 参数里而参与计算。

用返回值保存完整报文

下面的示例用两个类型字节作为前缀。为输出预留容量只是一个可选的缓冲区选择，不是调用成功的前提。代码没有在本文环境中执行，打印项用于说明读者可以观察的条件。

package main

import (
    "crypto/sha512"
    "fmt"
)

func main() {
    message := []byte("record:blue")
    h := sha512.New()
    // 标准库哈希的 Write 不返回错误；消息才是参与摘要的数据。
    _, _ = h.Write(message)
    prefix := make([]byte, 2, 2+h.Size())
    prefix[0], prefix[1] = 0x21, 0x04
    // Sum 追加的是二进制摘要，必须接住可能使用新底层数组的结果。
    out := h.Sum(prefix)
    digest := out[len(prefix):]
    fmt.Println(len(prefix), len(out), len(digest))
    fmt.Printf("prefix=%x\n", out[:len(prefix)])
}

按接口语义，三个长度应为 2、66、64，前缀应仍为 2104。这些是示例的预期条件，不是运行记录。digest 是 out 中摘要区间的切片视图，不是独立副本；需要单独持有并修改时，应复制该区间。

谁适合直接使用 Sum，谁适合先拿独立摘要

协议编码器已经持有前缀缓冲区时，Sum(prefix) 能直接表达“在末尾附加摘要”。日志格式化或业务比较只需要摘要本身时，Sum(nil) 更清楚，随后按需要格式化或复制。前缀由多个调用方共享时，应先明确其底层数组的所有权，避免把缓冲区复用误当成互不影响的值传递。

长度、容量和十六进制文本是不同问题

Sum 按切片的长度确定追加位置，不按容量确定位置。容量足够时，结果可能复用原底层数组；容量不足时，需要新的底层数组。无论哪种情况，都应使用返回值。忽略它后继续发送 prefix，会只发送原来的逻辑长度。

另一个容易混淆的点是二进制摘要与十六进制文本。SHA-512 摘要有 64 字节，转成十六进制字符串后是 128 个字符。直接 Sum(prefix) 追加的不是这 128 个可读字符。如果协议要求文本，应明确调用编码函数，而不是依赖打印格式来改变缓冲区。

接入现有代码时只改结果拼装

先找到现有消息 Write 的位置，再找到报文前缀，把旧的“取摘要再追加”表达替换成接住 Sum(prefix) 返回值。不要顺手把 prefix 写入 h，否则摘要对应的数据就变了。本文只讨论目标切片，不扩展到多轮哈希或文件读取。

// 保留报文头的逻辑长度，便于从完整结果中定位摘要区间。
prefixLen := len(prefix)
out := h.Sum(prefix)
if len(out) != prefixLen+h.Size() {
    panic("unexpected digest size")
}
// 检查前缀区间和摘要区间，不把容量当作报文长度。
header := out[:prefixLen]
digest := out[prefixLen:]
_ = header
_ = digest

这段是集成片段，h 和 prefix 使用调用方已有变量。读者的回归检查可以聚焦三项：前缀字节是否保留、结果长度是否增加 h.Size()、摘要区间是否等于同一状态的 Sum(nil)。若还要观察分配次数，应单独测量；本文不宣称预留容量带来某个性能提升。

常见疑问

调用 Sum 会清空已经写入的消息吗？

不会，Sum 不改变底层哈希状态。它也不是 Reset 的替代品。

想让前缀也参与摘要怎么办？

那是另一种消息定义，需要把前缀作为 Write 的输入。不要把这种定义和结果前缀混为一谈。

预留容量是不是必须的？

不是。正确性依赖接住返回值、明确前缀长度和数据归属，而不是依赖特定容量。最小写法仍是 out := h.Sum(prefix)。