Go sha512.New512_256 和 New512 有什么区别

在 Go 的 crypto/sha512 包里，sha512.New512_256 和 sha512.New512 都返回 hash.Hash，但它们代表两个不同的摘要算法。最直接的区别是输出长度：SHA-512/256 输出 32 字节，SHA-512 输出 64 字节；更重要的是，SHA-512/256 不是把 SHA-512 的结果截取前 256 位，算法身份和初始值也不同。

如果协议、文件格式或已有校验值写的是 SHA-512/256，就用 New512_256；只有在上下游明确约定 SHA-512 时才用 New512。不能只看“都是 SHA-512 家族”就互换。

先看摘要长度，再确认算法身份

Go 源码把 Size 定义为 64，把 Size256 定义为 32，并分别提供 New、New512_256 和对应的快捷函数。名称里的“256”描述的是 SHA-512/256 的摘要位数，不是 Go 在运行结束后随手把 SHA-512 的十六进制字符串砍半。

这一区分会直接影响兼容性。假设一个文件清单保存的是 64 个字节的 SHA-512 值，改成 32 个字节的 SHA-512/256 后，即使输入文件完全相同，旧清单也不会因为“前半段看起来像”而自动兼容。NIST 的 SHA-512/t 规范为不同 t 使用独立的初始哈希值，Go 的两个构造函数也因此不能互换。

用同一输入并排计算两个结果

下面的示例故意复用同一个输入，分别创建两个独立的 hash.Hash。代码只依赖标准库，输出转成十六进制后便于放入文件清单或日志；真正保存时仍应遵守你的协议规定。

package main

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

func digest(h hash.Hash, data []byte) string {
    // 一次 Write 写入待摘要内容；Hash 会累计后续写入的数据。
    if _, err := h.Write(data); err != nil {
        panic(err) // hash.Hash 的标准实现不会返回写入错误，这里保留异常边界。
    }
    // Sum(nil) 追加当前摘要，转十六进制后便于跨系统传输和比较。
    return hex.EncodeToString(h.Sum(nil))
}

func main() {
    data := []byte("go-sha512-choice")
    sha512Value := digest(sha512.New(), data)
    sha512_256Value := digest(sha512.New512_256(), data)

    fmt.Printf("SHA-512: %d bytes %s\\n", len(sha512Value)/2, sha512Value)
    fmt.Printf("SHA-512/256: %d bytes %s\\n", len(sha512_256Value)/2, sha512_256Value)
}

这里的字符串长度除以 2 才是摘要字节数，因为十六进制编码会让每个字节占两个字符。两个结果都来自同一份输入，但算法构造不同，所以不能把 sha512Value[:64] 当成 New512_256 的替代值。

按协议字段和存储边界做选择

若代码采用流式读取文件，循环调用 Write 即可；文件读完后再调用 Sum(nil)。一个 Hash 会保留已经写入的数据，复用同一实例前要调用 Reset，更稳妥的做法是为每个独立对象创建新的 Hash，避免把两个文件或两个字段意外拼接成同一个摘要。

迁移前的四项检查

第一，确认文档写的是 SHA-512 还是 SHA-512/256，不要用“SHA-512 的 256 位版本”这种模糊描述代替算法名。第二，检查数据库列、JSON 字段、校验文件和接口参数的长度。第三，统一原始摘要还是十六进制字符串的约定，避免把 32 字节误当成 32 个字符。第四，准备固定输入的测试向量，并同时验证算法名称、字节长度和最终字符串。

如果只是内部去重，长度和碰撞预算可以参与选型；如果要和其他语言、旧版本工具或外部协议互通，兼容约定优先。换构造函数不是简单的性能开关，而是一次数据格式变更，应该连同回滚方式一起记录。

常见问题

New512_256 是不是 New512 结果的前 32 字节？

不是。它使用 SHA-512/256 变体的算法定义和初始值，虽然共享 SHA-512 家族的压缩结构，但结果不能用截断替代。

为什么两个函数都返回 hash.Hash？

这是统一的流式摘要接口，调用方可以用相同的 Write、Sum 和 Reset 方式工作；统一接口不表示摘要值兼容。

只比较十六进制字符串长度够不够？

不够。还要确认算法名、原始摘要字节数、编码形式以及上下游是否使用同一测试向量。