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

可以用 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，收到一段数据就更新内部状态，最后再取摘要。

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

用 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，所以这里的顺序不能写反。它返回已写入的字节数与错误；校验场景通常只关心错误，但如果还要记录文件大小，可以保存返回的字节数。

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

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

不要把 SHA-256 当成加密或唯一身份证明

SHA-256 是摘要算法：相同字节序列会得到相同摘要，输入改变一个字节通常就会得到不同结果，但摘要本身不能还原原文。它适合检查下载文件、构建产物或缓存内容是否发生变化；如果场景是密码存储、消息认证或需要密钥的完整性保护，应选择针对该场景设计的方案，不要只把哈希字符串当作安全凭证。

另外，摘要只反映实际读到的字节。若文件在读取过程中被其他进程修改，得到的结果可能对应一个混合时刻的内容；需要稳定快照时，应先使用文件系统或存储层提供的一致性机制。

常见问题

能不能用 io.CopyBuffer？可以。它允许调用方提供复用缓冲区，适合需要统一 I/O 缓冲策略的程序；仅为计算摘要时，io.Copy 已经足够简洁。

为什么不直接比较 [32]byte？sha256.Sum256 返回数组，适合内存数据；流式对象最终返回的是字节切片。对外展示或落盘时使用统一十六进制编码，跨语言和命令行工具比对更直观。

相关实现可参考 Go 官方 crypto/sha256 文档、io 文档 与 os 文档。