Go crypto/sha256.New 怎样用 New 对长数据做流式 SHA-256
处理大文件、上传内容或持续到达的数据时,不适合先把全部字节读进内存再调用一次 sha256.Sum256。更稳妥的做法是先调用 sha256.New() 得到一个 hash.Hash,再把数据分段写入同一个哈希状态,最后通过 Sum(nil) 取出 SHA-256 摘要。
官方文档:https://pkg.go.dev/crypto/sha256#New
这套方式的重点不是“边读边得到最终字符串”,而是让哈希器保存累计状态:输入可以分成很多块,最终摘要仍然等价于一次性处理完整内容。
先确认 sha256.New 返回什么
sha256.New() 不接收数据参数,返回的是一个新的 hash.Hash。刚创建时它只代表一个空的 SHA-256 计算状态,必须先调用 Write 或把它交给能够写入的复制函数。
package main
import (
"crypto/sha256"
"fmt"
)
func main() {
h := sha256.New() // 创建独立的 SHA-256 状态,后续输入都写入它
_, _ = h.Write([]byte("part-a")) // 示例省略错误处理,真实 Reader 场景要检查错误
_, _ = h.Write([]byte("part-b")) // 连续写入会累积状态,不会覆盖上一段输入
sum := h.Sum(nil) // nil 表示不追加前缀,只取当前累计摘要
fmt.Printf("%x\n", sum) // 十六进制只改变展示方式,不改变摘要字节
}
示例里的两个 Write 作用在同一个 h 上,所以它表达的是字符串 part-apart-b 的连续摘要。若在中间重新调用 sha256.New(),就会得到另一段独立计算,前面的状态不会自动带过去。
让多段数据进入同一个哈希状态
长数据通常已经存在于文件、网络响应或其他 io.Reader 中。这时可以把哈希器作为目标 Writer 交给 io.Copy,数据会被分段搬运,代码不需要自行维护缓冲区。
package main
import (
"crypto/sha256"
"fmt"
"io"
"os"
)
func fileSHA256(path string) ([]byte, error) {
f, err := os.Open(path)
if err != nil {
return nil, err // 打开失败时不要创建一个看似有效的空摘要
}
defer f.Close() // 函数返回时释放文件描述符,避免长任务累积资源
h := sha256.New() // 哈希状态只绑定这一份文件输入
if _, err := io.Copy(h, f); err != nil {
return nil, err // 读取或写入哈希器失败时把错误交给调用方
}
return h.Sum(nil), nil // 所有输入完成后再取最终摘要
}
func main() {
sum, err := fileSHA256("data.bin")
if err != nil {
panic(err) // 示例入口直接终止;服务代码应返回或记录错误
}
fmt.Printf("%x\n", sum) // SHA-256 摘要固定为 32 字节
}
io.Copy 的关键点是目标参数:哈希器实现了 io.Writer,所以每一块读到的数据都会进入它的内部状态。文件再大,也不需要把整个文件组装成一个巨大的 []byte。这不是并发计算;同一个哈希器仍应由一个明确的输入顺序驱动。

在最后用 Sum(nil) 取摘要
hash.Hash.Sum 的参数容易被误读。它不是“要计算的输入”,而是一个要追加到返回结果前面的字节切片。常见的取最终摘要写法是 h.Sum(nil);如果传入已有切片,返回值会在该切片后追加摘要。
package main
import (
"crypto/sha256"
"encoding/hex"
"fmt"
"strings"
)
func digestText(parts ...string) string {
h := sha256.New() // 所有片段共用一个状态,顺序就是输入顺序
for _, part := range parts {
if _, err := h.Write([]byte(part)); err != nil {
return "" // hash.Hash 当前实现通常不返回错误,但接口契约仍应保留处理位
}
}
return hex.EncodeToString(h.Sum(nil)) // 32 字节摘要编码成 64 个十六进制字符
}
func main() {
fmt.Println(strings.TrimSpace(digestText("go", "-", "stream"))) // 仅展示稳定格式
}
摘要字节长度由 sha256.Size 表示,值为 32;转成十六进制后通常是 64 个字符。不要把十六进制文本再次当作原始摘要参与比较,也不要用字符串长度代替对摘要内容的比较。

排查流式 SHA-256 的常见误区
| 现象 | 原因 | 处理方式 |
|---|---|---|
| 分块结果和一次性结果不同 | 分块之间创建了新的哈希器,或输入顺序变化 | 整段数据使用同一个 hash.Hash,保持顺序一致 |
| 把 Sum 的参数当成输入 | 误以为 h.Sum(data) 会计算 data | 先用 Write 输入,最终通常使用 h.Sum(nil) |
| 大文件处理时内存上涨 | 先调用 io.ReadAll 再哈希 | 直接使用 io.Copy(h, reader) 或受控分块 Write |
| 摘要长度判断错误 | 把十六进制字符串长度当成原始字节长度 | 原始结果看 sha256.Size,展示文本再看编码规则 |
还要注意,读取源的错误不能被“有摘要返回”掩盖。只要 io.Copy 或底层 Read 报错,就应该把错误返回给调用方,而不是把部分输入产生的摘要当成完整文件的校验值。
相关问题
sha256.New 和 sha256.Sum256 怎么选?
输入已经完整且适合放在内存中时,Sum256(data) 更直接;输入来自文件、网络或分段消息时,New 配合 Write 或 io.Copy 更合适。
调用 Sum(nil) 后还能继续 Write 吗?
可以把 Sum 理解为读取当前状态的快照,它不会像重新初始化那样清空哈希器;但要得到另一份独立摘要,建议新建哈希器,避免把两次业务输入混在同一状态里。
小结:sha256.New 负责创建可持续写入的 SHA-256 状态;长数据通过同一个哈希器流入,完成后用 Sum(nil) 取 32 字节摘要。真正需要排查时,优先确认是否重复创建、是否忽略读取错误,以及是否混淆了原始摘要和十六进制展示文本。
Go crypto/rand.Prime 为什么 Prime 的位数参数不能过小
- 上一篇
- Go crypto/rand.Prime 为什么 Prime 的位数参数不能过小
- 下一篇
- Go crypto/sha256.New 为什么 Sum 之后仍能继续写入同一个哈希对象
-
- Golang · Go教程 | 17分钟前 | go · Go io.Copy crypto/sha512 流式哈希
- Go crypto/sha512.New 怎样为长输入选择 SHA-512 流式哈希
- 306浏览 收藏
-
- Golang · Go教程 | 26分钟前 | go · 源码分析 · Go go/build ImportComment 规范导入路径
- Go build.ImportComment 怎样读取包声明中的规范导入路径
- 185浏览 收藏
-
- Golang · Go教程 | 42分钟前 | 标准库 · RSA · Go教程 · 工程实践 · 密码学 · RSA Go crypto/rsa GenerateKey 密钥位数 公钥密码
- Go crypto/rsa.GenerateKey 怎样设置 RSA 密钥位数
- 456浏览 收藏
-
- Golang · Go教程 | 47分钟前 | 标准库 · 编码 · Go教程 · 工程实践 · base64 Go StdEncoding encoding/base64 流式编码 NewEncoder
- Go encoding/base64.NewEncoder 怎样把流式数据编码为 Base64
- 206浏览 收藏
-
- Golang · Go教程 | 55分钟前 | 标准库 · Go教程 · 密码学 · 安全编程 · Go 椭圆曲线 crypto/ecdh ECDH PrivateKey.PublicKey 公钥对象
- Go crypto/ecdh.PrivateKey.PublicKey 怎样从私钥得到公钥对象
- 299浏览 收藏
-
- Golang · Go教程 | 1小时前 | 标准库 · Go教程 · 密码学 · 安全编程 · Go crypto/subtle ConstantTimeSelect 常量时间选择 安全比较
- Go crypto/subtle.ConstantTimeSelect 怎样在两个整数结果间做常量时间选择
- 212浏览 收藏
-
- Golang · Go教程 | 1小时前 | 标准库 · Go教程 · 密码学 · 安全编程 · Go crypto/subtle WithDataIndependentTiming ConstantTimeCompare 数据无关时序
- Go crypto/subtle.WithDataIndependentTiming 怎样让回调中的操作保持数据无关时序
- 243浏览 收藏
-
- Golang · Go教程 | 1小时前 | 切片 · 标准库 · 泛型 · Go教程 · Go 结构体比较 cmp.Compare 泛型切片 slices.MinFunc
- Go slices.MinFunc 怎样按自定义规则找出最小元素
- 273浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1134次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1116次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1294次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1234次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1086次使用
-
- GScript 编写标准库示例详解
- 2022-12-30 369浏览
-
- 关于Golang标准库flag的全面讲解
- 2023-02-25 344浏览
-
- Golang标准库unsafe源码解读
- 2022-12-29 464浏览
-
- 快速掌握Go语言HTTP标准库的实现方法
- 2022-12-30 327浏览
-
- 解析golang 标准库template的代码生成方法
- 2022-12-24 349浏览

