本文介绍如何使用 io.TeeReader 在单次文件读取过程中同步计算哈希值并获取原始字节数据，避免重复 I/O，兼顾内存效率与代码简洁性。
本文介绍如何使用 io.teereader 在单次文件读取过程中同步计算哈希值并获取原始字节数据，避免重复 i/o，兼顾内存效率与代码简洁性。
在 Go 中，若需同时获取文件内容（[]byte）和其哈希值（如 SHA256），常见的错误做法是分两次读取文件：一次通过 io.Copy 计算哈希，另一次用 os.ReadFile 或 ioutil.ReadFile 加载全部内容——这不仅造成冗余磁盘 I/O，还违背了流式处理的设计哲学。
更高效的方式是利用 io.TeeReader：它包装一个 io.Reader（如打开的文件），并在每次读取时将数据透明地复制一份写入指定的 io.Writer（如哈希器），而调用方仍按常规方式读取原始数据流。整个过程仅遍历文件一次，零额外内存拷贝（除非你显式缓存全部字节）。
以下是完整实现示例：
package main
import (
"crypto/sha256"
"encoding/hex"
"fmt"
"io"
"os"
)
func readFileAndHash(fname string) ([]byte, string, error) {
f, err := os.Open(fname)
if err != nil {
return nil, "", fmt.Errorf("failed to open %s: %w", fname, err)
}
defer f.Close()
hasher := sha256.New()
// TeeReader 将从 f 读取的每个字节同时写入 hasher
tee := io.TeeReader(f, hasher)
// 一次性读取全部内容（也可分块读取以控制内存）
data, err := io.ReadAll(tee)
if err != nil {
return nil, "", fmt.Errorf("failed to read %s: %w", fname, err)
}
// 注意：必须在读取完成后调用 Sum(nil) 才能得到最终哈希
checksum := hex.EncodeToString(hasher.Sum(nil))
return data, checksum, nil
}
// 使用示例
func main() {
data, cksum, err := readFileAndHash("example.txt")
if err != nil {
panic(err)
}
fmt.Printf("File size: %d bytes\n", len(data))
fmt.Printf("SHA256: %s\n", cksum)
}
✅ 关键要点说明：
-
io.TeeReader是零拷贝的流式代理，不预分配缓冲区，适合大文件； - 哈希结果仅在全部数据读取完毕后才有效（
hasher.Sum(nil)必须在io.ReadAll之后调用）； - 若业务逻辑需「先验哈希再决定是否读取全文」，则
TeeReader不适用——此时应考虑两阶段方案（如先读头若干 KB 计算部分哈希 + 元信息校验），或接受双遍历（OS 页面缓存通常已大幅缓解性能损失）； - 如需同时支持多种哈希（SHA256 + MD5），可组合
io.MultiWriter与多个hash.Hash实例，再传入TeeReader。
综上，io.TeeReader 是 Go 标准库中实现「边读边算」的经典工具，简洁、安全、符合 io 接口抽象，是处理此类需求的首选方案。
