一行顶三行的 crypto.hash():本机实测小块快 1.7 倍,但哈希大文件反而慢 34%
给一段数据算 SHA-256,老写法是三行:createHash 建上下文、update 喂数据、digest 出结果。Node 21.7 起多了一个一行版的 crypto.hash('sha256', data),官方说法是「更快的快捷方式」。快多少、什么时候快、什么时候反而不快,文档只字未提,所以我拿本机把边界跑了一遍。
下面全部数据实测于 Windows + Node v22.22.2,每档跑 30~200 次取中位数,先预热再计时。
一、内存数据:小块快得明显,大块优势缩水
1 KB 数据:crypto.hash 中位数 0.003ms,createHash 0.005ms,快 1.69 倍。差距不在哈希本身(同样的 OpenSSL),而在省掉的 JS 包装:不用建 Hash 对象、不用链式调用、不用收尾 digest。
100 KB:0.093ms 对 0.098ms,只快 5%。10 MB:10.345ms 对 11.097ms,快 7%。数据一大,真正的耗时都在 OpenSSL 计算里,包装开销被摊平了。
最能拉开差距的是高频小块:64 字节连续调 20 万次,crypto.hash 共 249.2ms,createHash 共 539.1ms,每次省 0.0014ms。如果你在写限流器、缓存键、短链指纹这类每请求哈希几次的场景,这个比例(快 2.16 倍)是实打实的。
二、反直觉的一档:哈希 50MB 文件,流式反而快 34%
生成一个 50MB 文件,两种方案各跑 5 次取中位数:
整读 + crypto.hash(readFileSync 后一把喂进去):116.7ms
流式 createHash(1MB 缓冲循环 readSync):75.3ms
慢在哪?readFileSync 要先把 50MB 拷进一块连续内存,再整体传给哈希;流式方案复用同一块 1MB 缓冲,边读边喂,内存峰值和拷贝都少。两者 RSS 增量都不大(0~1MB,V8 回收及时),但 CPU 时间差出来了。
结论:crypto.hash 是给「数据已经在内存里」的场景用的。哈希文件,老老实实流式。
三、能干什么:输出、编码与等价性
输出一致性没问题:crypto.hash('sha256', buf) 与流式写法的 hex 结果逐字符相同;分片多次 update 的结果也和一次性哈希一致。
第三个参数是输出编码,我逐个试了:hex、base64、base64url、latin1、buffer 都支持,buffer 编码直接返回 32 字节的 Buffer,省一步 Buffer.from(hex, 'hex')。utf8 也能传但不报错——哈希结果不是文本,强行按 utf8 解出来就是一堆乱码,别这么用。
算法大小写不敏感(SHA256 和 sha256 同结果),md5、sha1、sha512、sha3-256、blake2b512 都在。传不存在的算法抛 Error,message 是 "Digest method sha257 is not supported",没有错误码,只能按 message 判断或提前包 try。
字符串输入默认按 utf8 转 Buffer,中文结果与手动 Buffer.from 一致,这块没有隐藏坑。
四、两个它做不到的事
一是 HMAC:crypto.hash 不支持,要 keyed 哈希还得用老 API(crypto.createHmac)。二是增量:数据必须一次给全,超过内存的大文件只能回到流式。
五、怎么用
const crypto = require('crypto');
const hex = crypto.hash('sha256', data); // 默认 hex 字符串
const raw = crypto.hash('sha256', data, 'buffer'); // 直接拿 Buffer
能换的场景:缓存键、短字符串指纹、请求签名前的摘要、配置文件校验——数据在内存里、只需要一次性结果,直接换,小块场景白捡最多 2 倍。
别换的场景:哈希磁盘上的大文件(用流式,实测快 34%)、需要 HMAC 的、需要边收数据边算的。
总结:crypto.hash() 是个诚实的快捷方式——它省掉的只是三行包装代码的开销,所以数据越小、调用越频,收益越大;一旦进入 OpenSSL 计算主导的大数据段,两种写法趋同。文件场景甚至倒挂。一行换三行值得,但换之前先想想你的数据从哪来。
- 点赞
- 收藏
- 关注作者
评论(0)