Go hash.Hash复用 Hash 前先重置状态的写法

在循环里反复计算摘要时，hash.Hash 可以复用，但每条新输入开始前必须调用 Reset()。Write 会把数据累加到当前状态，Sum 只读取并追加摘要，不会清空状态；如果省略重置，第二条输入算到的是“第一条+第二条”的摘要。

先看懂 hash.Hash 的三种状态操作

标准库的 hash.Hash 接口把摘要计算拆成了三个关键动作：Write 接收数据，Sum 取出当前摘要，Reset 恢复到刚创建时的状态。Size 和 BlockSize 只描述算法属性，不会改变输入状态。

用一个小型摘要计算器安全复用 Hash

把重置动作封装到计算方法内部，比要求每个调用方记住顺序更可靠。下面的示例使用 SHA-256，只演示复用边界，不把 Hash 当作并发安全对象。

package main

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

// DigestCalculator 把一个 hash.Hash 限定在串行的摘要计算流程内。
type DigestCalculator struct {
	h hash.Hash
}

// Digest 先清除上一次输入，再写入当前数据并返回独立的十六进制结果。
func (c *DigestCalculator) Digest(data []byte) (string, error) {
	c.h.Reset() // 复用对象的关键：隔离本次输入与上一条输入
	if _, err := c.h.Write(data); err != nil {
		return "", fmt.Errorf("写入摘要输入失败: %w", err)
	}
	sum := c.h.Sum(nil) // Sum 不会重置，因此下一次仍需先 Reset
	return hex.EncodeToString(sum), nil
}

func main() {
	calc := &DigestCalculator{h: sha256.New()}
	first, _ := calc.Digest([]byte("alpha"))
	second, _ := calc.Digest([]byte("beta"))
	fmt.Println(first, second)
}

这里的 Write 按 io.Writer 约定对标准库 Hash 实现不会返回错误，但保留错误分支可以让封装层在替换为包装器或其他实现时不悄悄丢失异常。摘要已经编码成新字符串，调用者无需持有 Hash 的内部状态。

三个容易把复用写错的边界

把 Sum 当成清空操作

h.Sum(nil) 只是把当前摘要追加到传入切片并返回结果，不会改变底层状态。若先写入 alpha，再直接写入 beta，结果对应的是连续输入，不是单独的 beta。

把同一个 Hash 放进并发请求

Reset、Write、Sum 都会围绕同一份内部状态工作，不能靠调用顺序猜测并发结果。HTTP 服务中应让每个请求拿到独立 Hash，或者在受控串行队列中复用；加锁虽然能保证串行访问，但通常不如按请求创建实例直观。

用共享前缀切片接收 Sum

Sum(b) 会把摘要追加到 b 后面。若 b 来自长期复用的可变缓冲区，调用方要明确它的长度、容量和后续修改边界；只需要摘要时使用 Sum(nil) 最不容易产生别名误解。

常见问题

Reset 应该放在 Sum 前还是 Write 前？

放在下一条输入的 Write 前最清晰。可以在上一次 Sum 后立即 Reset，但封装成“每次 Digest 开头 Reset”更不容易遗漏。

为什么连续调用 Sum 不需要 Reset？

因为 Sum 不改变状态，连续读取会得到同一段已写入数据的摘要。只有准备开始一条新输入时才需要 Reset。

复用 Hash 一定比每次 New 更快吗？

不能只凭直觉判断。小对象和低频路径优先保持代码简单；只有在明确的分配或吞吐压力下，才用基准测试比较复用、对象池和每次新建。

判断标准可以压缩成一句话：一条输入一个摘要状态；状态要复用，就在下一次写入前显式 Reset，并把并发隔离交给实例边界。