Go crypto/sha512.New512_256 怎样生成 256 位摘要

我在给文件指纹、协议字段或内容寻址记录做摘要时，常常不需要完整的 SHA-512 输出，而是希望得到一个固定、明确的 256 位结果。Go 标准库里的 sha512.New512_256 正好返回 SHA-512/256 的 hash.Hash：可以分段 Write 输入，最后用 Sum(nil) 取出 32 字节摘要，再按需要转成 64 个十六进制字符。

官方文档：https://pkg.go.dev/crypto/sha512#New512_256

sha512.New512_256() 适合需要连续写入或复用哈希状态的场景；如果输入已经完整放在一个 []byte 中，直接使用 sha512.Sum512_256(data) 会更短。两者的结果都是 SHA-512/256 的 32 字节摘要，不要把摘要当成可逆加密。

先确定：256 位摘要实际是多少字节

“256 位”不是 256 个字节，而是 32 个字节。crypto/sha512 同时提供 SHA-512、SHA-384、SHA-512/224 和 SHA-512/256，名称相近但输出长度不同。SHA-512/256 的固定长度由标准库的 sha512.Size256 表示，值为 32；如果把这 32 个字节转换为十六进制文本，每个字节占两个字符，最终通常是 64 个字符。

这个长度边界很重要：数据库字段、协议字段或缓存键如果按十六进制字符串保存，要预留 64 个 ASCII 字符；如果按二进制保存，则只需要 32 个字节。

用 New512_256 分段写入数据

New512_256 返回的是 hash.Hash 接口。它的好处是输入不必一次性拼成一个大切片：文件读取、网络分块或多个字段都可以按顺序写入同一个状态。下面的函数把多个字节块聚合成一个摘要，并返回二进制结果：

package main

import (
	"crypto/sha512"
	"fmt"
)

func digestChunks(chunks ...[]byte) []byte {
	// New512_256 返回 SHA-512/256 的哈希状态，最终摘要固定为 32 字节。
	h := sha512.New512_256()
	for _, chunk := range chunks {
		// hash.Hash.Write 按调用顺序累积输入；Write 对标准库哈希不会返回业务错误。
		_, _ = h.Write(chunk)
	}
	// Sum(nil) 返回当前摘要的副本，不会把哈希状态重置或改写。
	return h.Sum(nil)
}

func main() {
	// 分段输入适合文件块、消息片段或多个已经存在的字段。
	sum := digestChunks([]byte("header|"), []byte("payload"))
	fmt.Printf("摘要字节数：%d\n", len(sum))
}

这里的关键不是把 Write 写进循环，而是保持同一个 hash.Hash 实例。只要写入顺序相同，分成多个块写入与把相同字节拼成一块写入，摘要语义是一致的；一旦顺序改变，摘要也会改变。

用 Sum 读取摘要并转换成可传输文本

Hash.Sum(b) 的语义是“把当前摘要追加到 b 后面并返回结果”。因此 Sum(nil) 是最直观的 32 字节结果；如果调用方已经有前缀缓冲区，也可以传入已有切片，让摘要接在它后面。读取摘要不会自动清空状态，后续仍可继续写入。

package main

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

func digestText(data []byte) (string, error) {
	// 先创建 SHA-512/256 状态，再写入完整输入。
	h := sha512.New512_256()
	if _, err := h.Write(data); err != nil {
		// 保留错误分支，便于替换为自定义 Hash 实现时统一处理。
		return "", err
	}
	// Sum(nil) 得到 32 字节摘要；hex 编码后长度为 64 个字符。
	sum := h.Sum(nil)
	return hex.EncodeToString(sum), nil
}

func main() {
	// 文本表示适合日志、JSON 或只允许可打印字符的协议字段。
	text, err := digestText([]byte("hello sha512/256"))
	if err != nil {
		fmt.Println("摘要失败：", err)
		return
	}
	fmt.Println(text)
}

如果存储层允许二进制，直接保存 sum 可以节省空间；如果需要复制、日志记录或放入只接受文本的字段，再使用 hex.EncodeToString。不要把十六进制字符串的 64 个字符误当成摘要长度本身。

复用状态时先 Reset，单次输入可用 Sum512_256

同一个哈希对象在 Sum 后仍保留当前状态。如果准备计算下一条完全独立的数据，先调用 Reset，否则下一条输入会接在上一条输入后面。这个边界在对象池或批量处理代码里尤其容易被忽略：

package main

import (
	"crypto/sha512"
	"fmt"
)

func digestTwoRecords(first, second []byte) ([]byte, []byte) {
	h := sha512.New512_256()

	// 第一条记录完成后读取摘要，但不把 h 当成已经清空。
	_, _ = h.Write(first)
	firstSum := h.Sum(nil)

	// Reset 把状态恢复到初始值，避免第二条记录继承第一条输入。
	h.Reset()
	_, _ = h.Write(second)
	secondSum := h.Sum(nil)
	return firstSum, secondSum
}

func main() {
	// 这里仅展示两次独立摘要的状态边界，不比较摘要内容。
	a, b := digestTwoRecords([]byte("record-a"), []byte("record-b"))
	fmt.Println(len(a), len(b))
}

如果输入已经是一个完整的字节切片，不需要维护可复用状态，可以直接调用 sha512.Sum512_256(data)。它返回类型为 [sha512.Size256]byte 的数组，适合“输入一次、结果一次”的小函数；需要分块读取、连续写入或使用 hash.Hash 接口时，再选择 New512_256。

把摘要用于正确的边界，而不是当成密码方案

SHA-512/256 的摘要适合做内容比较、文件指纹、缓存键组成部分或协议中的摘要字段，但“固定长度”不代表不会碰撞，也不代表可以从摘要还原原文。涉及口令存储、密钥派生、消息认证或签名时，应使用相应的标准方案与专用 API，不能仅因为 sha512 名字里有“安全”就直接替代它们。

我的实际判断通常只有三步：输入是否需要分段写入；结果是按 32 字节存储还是按 64 字符文本传输；哈希对象是否会跨记录复用。如果输入一次性可得，优先用 Sum512_256 保持代码短；如果输入来自流或多个块，使用 New512_256，并在每条独立记录开始前确认状态是否已经 Reset。

常见问题

SHA-512/256 的结果是 32 字节还是 64 字节？二进制摘要是 32 字节；转换为十六进制后通常是 64 个字符。

Sum(nil) 会清空哈希对象吗？不会。它读取当前摘要并返回结果，后续写入仍会延续原状态。

为什么不直接使用 sha512.Sum512_256？完整输入已经在一个切片中时，一次性函数更简洁；需要流式或分段输入时，New512_256 更合适。

可以用 SHA-512/256 保存用户密码吗？不应直接这样做。密码存储需要专门的慢哈希和参数配置，摘要函数本身不等同于密码存储方案。