本文介绍如何正确使用 io.MultiWriter 与 cipher.StreamWriter 组合，在一次数据流复制过程中同时完成加密写入和密文哈希计算，避免误对明文哈希。
本文介绍如何正确使用 io.multiwriter 与 cipher.streamwriter 组合，在一次数据流复制过程中同时完成加密写入和密文哈希计算，避免误对明文哈希。
在 Go 的密码学实践中，一个常见误区是将 io.MultiWriter 直接用于 io.Copy 的目标端（如 io.MultiWriter(writer, hash)），期望它能同时向加密写入器和哈希器写入同一份数据。但问题在于：cipher.StreamWriter 本身是一个包装写入器，其 Write 方法会先对输入字节流执行加密（CTR 模式下为异或运算），再将密文写入底层 W。因此，若将 hash 与 writer 并列置于 MultiWriter 中，hash 实际接收的是原始明文——因为 io.Copy 向 MultiWriter 写入时，尚未经过 StreamWriter 的加密处理。
✅ 正确做法是：将 io.MultiWriter 作为 cipher.StreamWriter 的底层写入器（即 W 字段）。这样，所有经 StreamWriter 加密后的字节，会自动、同步地分发至文件和哈希器：
// ✅ 正确：MultiWriter 作为 StreamWriter 的 W，确保 hash 计算的是密文
writer := &cipher.StreamWriter{
S: cipher.NewCTR(block, iv),
W: io.MultiWriter(writeFile, hash), // ← 密文同时写入文件 + 更新 hash
}
writeFile.Write(iv) // 先写入 IV（明文，不参与加密流）
if _, err := io.Copy(writer, readFile); err != nil {
fmt.Println("error during crypto:", err)
return "", err
}
⚠️ 注意事项：
-
IV 必须单独写入：CTR 模式要求初始化向量（IV）以明文形式前置存储，但它不属于加密流的一部分，因此不能通过
StreamWriter处理，否则会被错误加密或影响哈希结果。 -
哈希器需支持并发安全写入：
hash.Hash接口实现（如sha256.New()）通常不是并发安全的；本例中因所有写入均来自单一线程的io.Copy，故无需额外同步。 -
避免嵌套 MultiWriter：不要在
MultiWriter内部再包裹StreamWriter，这会导致逻辑混乱和数据流向错误。 -
验证完整性：最终可调用
hash.Sum(nil)获取密文哈希值，用于后续校验或签名。
通过该结构，你仅需一次 io.Copy 即可高效完成“读取 → 加密 → 写文件 + 计算密文哈希”全流程，兼顾性能与安全性。
