当前位置：首页 > 文章列表 > Golang > Go教程 > Go crypto/sha256 怎么边读文件边计算校验值

Go crypto/sha256 怎么边读文件边计算校验值

来源：17golang原创 2026-09-07 14:42:12 0浏览收藏

可以用 sha256.New() 创建一个流式哈希对象，再把文件作为 Reader 交给 io.Copy。这样文件会分段进入哈希计算，不需要先用 os.ReadFile 把整个文件装进内存；复制完成后调用 h.Sum(nil)，再用 %x 输出 64 位十六进制校验值。

核心写法是：os.Open → sha256.New → io.Copy(hash, file) → h.Sum(nil)。打开失败和读取失败要分别处理，文件也要在成功打开后关闭。

为什么不用 os.ReadFile 再调用 Sum256

sha256.Sum256(data) 适合已经在内存里的短数据，例如配置片段或请求体。文件可能远大于可接受的内存预算时，应改用实现了 hash.Hash 的对象。sha256.New 返回的哈希对象同时是 Writer，收到一段数据就更新内部状态，最后再取摘要。

因此，本文的“边读边算”不是一边读取一边得到最终字符串，而是让读取器持续写入哈希对象；只有读到文件末尾且没有错误后，摘要才是完整的。

Go 内存数据摘要与文件流式 SHA-256 的输入边界关系图 — 图2：短字节数据适合 Sum256，而文件校验通过 Reader 与 hash.Hash 保持流式输入边界。

用 io.Copy 把文件内容流入 SHA-256

下面的函数只返回摘要字符串和错误。注释保留了每个资源边界，便于把它放进命令行工具、上传前校验或构建产物检查中。

package main

import (
    "crypto/sha256"
    "fmt"
    "io"
    "os"
)

// fileSHA256 以流式方式计算文件摘要，不把文件整体读入内存。
func fileSHA256(path string) (string, error) {
    f, err := os.Open(path)
    if err != nil {
        return "", fmt.Errorf("打开文件失败: %w", err)
    }
    defer f.Close() // 文件成功打开后，无论后续是否出错都释放描述符。

    h := sha256.New() // h 同时实现 io.Writer，接收分段文件内容。
    if _, err := io.Copy(h, f); err != nil {
        return "", fmt.Errorf("读取并计算摘要失败: %w", err)
    }

    return fmt.Sprintf("%x", h.Sum(nil)), nil // %x 将 32 字节摘要编码为十六进制。
}

func main() {
    sum, err := fileSHA256("artifact.zip")
    if err != nil {
        fmt.Fprintln(os.Stderr, err)
        return
    }
    fmt.Println(sum)
}

io.Copy 的两个参数分别是 Writer 和 Reader，所以这里的顺序不能写反。它返回已写入的字节数与错误；校验场景通常只关心错误，但如果还要记录文件大小，可以保存返回的字节数。

Go 文件读取、io.Copy 与 SHA-256 摘要的静态关系图 — 图1：文件作为 Reader，io.Copy 连接 SHA-256 Writer，最终得到摘要字节与十六进制结果。

文件偏移、空文件和输出格式怎么判断

文件偏移：传入的文件从当前偏移处开始读取。如果文件之前执行过 Seek，应先回到开头，否则算出的只是剩余片段的摘要。
空文件：没有内容也有确定的 SHA-256 摘要，io.Copy 会正常结束，不应把“写入字节数为 0”当成错误。
输出格式：h.Sum(nil) 得到 32 字节；%x 输出 64 个小写十六进制字符。若要大写，可在结果字符串上使用 strings.ToUpper，但比较双方必须统一格式。
关闭错误：普通只读校验通常以读取错误为主；若业务必须确认关闭动作，也可以改为显式关闭并记录 Close 返回值。