sha256.Sum256适用于一次性小数据哈希,零分配、快、返回[32]byte;sha256.New()用于流式大输入,需配合io.Copy,二者不可互换,类型和取值方式必须严格匹配。

sha256.Sum256 和 sha256.New() 不是可互换的两个函数,选错就编译失败或结果为空——关键看你要哈希的是“一次性小数据”还是“流式大输入”。
字符串哈希优先用 sha256.Sum256
它零分配、快、一行搞定,返回值类型 [32]byte,适合密码、token、配置项等纯内存数据。
-
sha256.Sum256([]byte("hello"))直接返回结构体,不是接口,不能Write,也不能复用 - 转十六进制用
fmt.Sprintf("%x", sum)最轻量,不用引encoding/hex - 要 Base64 编码必须写
sum[:]转切片,否则base64.StdEncoding.EncodeToString(sum)会编译报错 -
fmt.Println(sum)输出的是{[107 157 ...]}这种字面量,不是哈希串,别误以为成功了 - 别把
sum直接传给需要[]byte的函数(比如json.Marshal),类型不兼容
文件或网络流必须用 sha256.New() + io.Copy
哪怕 100MB 文件,os.ReadFile 也会 OOM;sha256.Sum256 根本不支持流式输入,硬套只会算错。
- 固定三步:
os.Open→sha256.New()→io.Copy(h, file) - 必须
defer file.Close(),否则 fd 泄露,跑几天就too many open files -
io.Copy返回 error 必须检查——磁盘满、NFS 中断、权限不足都在这儿暴露 - 机械硬盘建议包一层
bufio.NewReader(file);SSD 上可省 -
h.Sum(nil)返回[]byte,直接喂给fmt.Sprintf("%x", ...)或base64.StdEncoding.EncodeToString
Sum(nil) 和 Sum32() 别混用
这是最常导致 panic 或空结果的坑:不同哈希包的取值方法语义完全不同。
-
crypto/sha256.New()只有Sum(nil),调Sum32()编译直接失败 -
hash/fnv.New32a()必须用Sum32(),Sum(nil)虽不报错但返回空切片,语义错误 -
Sum(nil)中的nil表示“新建底层数组”,不是“传空参数”;写成h.Sum([]byte{})或h.Sum([]byte("xxx"))是把哈希值追加到那串字节后面,不是算哈希
空字符串、空文件、路径错误必须显式处理
生产环境里 os.Open 失败太常见,但很多人只写 if err != nil { panic() } 或干脆忽略。
- 空文件哈希结果是固定的:
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855(即空字符串 SHA256) - 路径不存在、权限不足、符号链接断裂都会在
os.Open阶段返回 error,得提前判断 - 别依赖
io.Copy自动兜底——它只负责读写错误,不处理打开失败
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











