crypto/md5.sum() 返回结构体而非字符串，需用 fmt.sprintf("%x", sum) 或 hex.encodetostring(sum[:]) 转为十六进制字符串；md5.new() 适用于流式计算，md5.sum() 适合一次性哈希；md5 仅用于校验或缓存，不可用于密码存储。
crypto/md5.Sum() 返回的是结构体，不是字符串
很多人调用 md5.Sum() 后直接打印，看到类似 {[123 45 67 ...]} 的输出，误以为是“乱码”或“失败”。其实它返回的是 md5.Sum 类型的结构体，.Sum 字段才是原始字节数组，要转成十六进制字符串得手动调用 fmt.Sprintf("%x", sum) 或 hex.EncodeToString()。
常见错误现象：
– 打印 md5.Sum([]byte("hello")) 得到 {[138 214 110 ...]}，不是预期的 "5d41402abc4b2a76b9719d911017c592"
– 误用 string(sum[:]) 导致不可见字符或 panic（越界）
- 正确做法：先调用
sum := md5.Sum(data)，再用fmt.Sprintf("%x", sum) - 如果需要
[]byte形式的哈希值，用sum[:]（注意冒号，这是切片语法） - 若需
string类型十六进制结果，优先用hex.EncodeToString(sum[:])，更明确、不易错
md5.New() 和 md5.Sum() 的使用场景不同
md5.New() 返回一个可多次写入的哈希对象，适合处理大文件、流式数据或分块输入；md5.Sum() 是一次性计算函数，只接受完整 []byte，内部不维护状态，性能略高但灵活性差。
使用场景：
– 读文件时逐块 io.Copy() 到 hash.Hash 对象 → 用 md5.New()
– 简单字符串哈希（如密码临时校验、缓存 key）→ 用 md5.Sum() 更简洁
- 用
md5.New()后必须调用h.Sum(nil)获取结果，不是h.Sum() -
h.Sum(nil)返回的是新分配的[]byte；而md5.Sum()的sum[:]是对内部数组的引用，零分配 - 别混用：不能对
md5.Sum()的结果再调.Write()—— 它不是hash.Hash接口实现
MD5 不适合密码存储，但可用于完整性校验
Go 的 crypto/md5 实现本身没问题，问题出在算法选择上。MD5 已被证实碰撞容易、计算太快，任何涉及用户密码、token 签名的场景都该换 bcrypt、scrypt 或 Argon2。
但它仍广泛用于：
– 文件下载后比对 md5sum 值
– 构建缓存 key（如模板渲染结果 + 参数字符串）
– 内部服务间轻量级数据指纹（无安全对抗需求）
- 若用于校验，确保输入字节完全一致：注意字符串编码（UTF-8）、换行符（
\nvs\r\n）、空格结尾等 - 不要把 MD5 当加密用——它不可逆但可穷举，且无法加盐（
md5(salt + pwd)仍是弱模式） - 标准库没有内置加盐 MD5，也别自己拼接 salt 后哈希，这不属于合规密码实践
注意 Go 版本差异：Sum() 方法签名没变，但 Sum() 的参数含义易误解
hash.Hash.Sum() 方法带一个 []byte 参数，常被误认为“要追加到哪”，实际它是“把哈希值追加到该切片末尾并返回新切片”。传 nil 最安全，传非 nil 切片可能引发意外扩容或覆盖。
错误写法：buf := make([]byte, 0, md5.Size); h.Sum(buf) → 看似预分配，但若 buf 非空，结果会拼在旧内容后面
- 统一用
h.Sum(nil)，语义清晰，Go 运行时也优化了这种零分配路径 -
md5.Size是常量 16（字节），对应 32 位十六进制字符串 - 别依赖
len(h.Sum(nil)) == 16做逻辑判断——虽然当前成立，但这是实现细节，不是 API 合约
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
