Go crypto/sha512.New384 为什么输出长度是 48 字节

你在Go项目里调用crypto/sha512.New384()生成哈希摘要，最终得到的字节数组长度固定是48，很多刚接触的朋友会纳闷这个函数明明放在sha512标准库包里，怎么输出不是预期的64字节，这其实是算法标准本身的定义导致的，和Go的实现逻辑没有特殊关系。

sha512.New384输出48字节，完全对应SHA-384算法规范里定义的384位摘要长度，384位换算为字节刚好就是48字节。

我第一次把 sha512.New384() 接到日志摘要代码里时，最容易误读的不是算法名，而是“输出长度”。New384 返回的是 SHA-384 哈希对象，摘要的原始结果固定是 48 字节；如果再把这 48 个字节编码成十六进制字符串，字符串长度会变成 96 个字符。两者都叫“摘要”，但不是同一种表示。

记住一个边界：sha512.New384() 的摘要长度是 48 字节；十六进制展示通常是 96 个字符；Sum(b) 还会把摘要追加到传入的切片后面。

New384 返回的到底是什么

crypto/sha512 提供的 New384 返回一个实现 hash.Hash 的对象。它的名字已经暗示了用途：用 SHA-384 规则持续接收输入，然后在需要时生成摘要。这里的“384”不是直接等于 384 字节，而是 384 位；换算成字节就是 384 / 8 = 48。

因此，下面这段代码拿到的 digest 是原始字节切片，长度应按字节数理解：

package main

import (
    "crypto/sha512"
    "fmt"
)

func main() {
    h := sha512.New384()
    _, _ = h.Write([]byte("hello, Go")) // 将输入交给哈希对象

    digest := h.Sum(nil) // nil 表示不预先放入前缀
    fmt.Println(len(digest)) // 48
}

为什么转成十六进制后是 96 个字符

原始摘要的每个字节有 8 位，通常用两个十六进制字符表示一个字节。所以 48 字节编码后得到 48 × 2 = 96 个 ASCII 字符。这个长度变化来自展示编码，不代表哈希对象产生了更长的原始摘要。

package main

import (
    "crypto/sha512"
    "encoding/hex"
    "fmt"
)

func main() {
    h := sha512.New384()
    _, _ = h.Write([]byte("hello, Go"))

    raw := h.Sum(nil)             // 原始摘要：48 字节
    text := hex.EncodeToString(raw) // 展示文本：96 个字符
    fmt.Println(len(raw), len(text))
}

如果接口要求固定宽度的十六进制文本，可以保存 text；如果接口要求二进制摘要或继续做字节级处理，就应该保留 raw。不要用字符串长度去反推算法的摘要长度。

Sum 的参数不是“输出缓冲区”

hash.Hash.Sum(b) 的语义很容易让人写错：它不会把摘要写进一个固定容量的空白缓冲区，而是返回“原来的 b 加上当前摘要”的结果。因此，h.Sum(nil) 得到纯摘要；h.Sum(prefix) 得到前缀和摘要拼接后的切片。

prefix := []byte("sha384:")
out := h.Sum(prefix)

// out 的前 7 个字节仍是 prefix，后面追加 48 字节摘要。
// 如果调用方只想保存摘要，应使用 h.Sum(nil)。

我会怎样给这段代码划边界

对我来说，最稳妥的做法是先决定下游需要哪种数据，再决定调用方式。需要原始摘要时，使用 h.Sum(nil) 并按 48 字节处理；需要可读文本时，再显式调用十六进制编码；需要带协议前缀的缓存键时，才传入已有前缀切片。

还要留意哈希对象的状态。多次调用 Write 会把输入视为连续数据，多次调用 Sum 只读取当前状态，不会自动清空对象。如果要重新计算另一份独立输入，通常应新建一个哈希对象，而不是误以为读取摘要后状态已经重置。

常见疑问

New384 和 SHA-512 是同一种摘要长度吗？

不是。它们都属于 crypto/sha512 包，但 New384 对应 SHA-384，原始摘要是 48 字节；名称相近不等于输出宽度相同。

为什么我的摘要字符串不是 48 位？

如果你使用了十六进制编码，看到的应是 96 个字符。那是编码后的文本长度；只有在还没编码的字节切片上，len 才对应 48 字节。

可以直接复用 Sum 返回的切片吗？

可以把它作为当前结果传递，但要明确它可能包含传入的前缀，而且后续逻辑不应把它误当成新的哈希状态。需要独立摘要时，使用 h.Sum(nil) 并由调用方管理返回切片。

把“位数、字节数、十六进制字符数”和“Sum 的追加行为”分开后，sha512.New384 就不再神秘：算法规格决定 48 字节原始摘要，编码方式决定展示长度，调用者传入的切片决定返回值是否带前缀。