17370845950

md5.Sum()和sha256.Sum()返回结构体，需用.Sum(nil)[:]转字节切片再hex.EncodeToString()；大文件须io.Copy流式计算；无sha256.File()；校验优先用sha256并严格处理error。

md5.Sum() 和 sha256.Sum() 的返回值不是字符串，别直接 fmt.Println

很多人调用 md5.Sum(nil) 或 sha256.Sum(nil) 后，直接用 fmt.Println 打印，结果看到一串类似 {[123 45 67 ...]} 的字节切片输出——这不是哈希值的可读形式。这两个函数返回的是结构体（如 md5.Sum），其 [0:len] 字段才是原始字节数组，需显式转换为十六进制字符串。

• 正确做法是调用 .Sum(nil)[:] 获取字节切片，再用 hex.EncodeToString() 转成小写十六进制字符串
• Sum(nil) 中的 nil 表示不复用已有切片，安全但略低效；若反复计算可传入预分配的 [md5.Size]byte 提升性能
• 注意：md5.Sum 和 sha256.Sum 类型不兼容，不能混用变量或函数参数

计算大文件哈希必须用 io.Copy + hash.Hash，不能一次性读入内存

对几百 MB 或 GB 级别的文件，用 os.ReadFile() 全部加载进内存会触发 OOM 或严重拖慢程序。正确路径是打开文件句柄，通过 io.Copy() 流式写入哈希对象——因为 hash.Hash 接口实现了 io.Writer。

• 必须用 defer f.Close() 确保文件关闭，否则可能泄露 fd
• 推荐使用 bufio.NewReader(f) 包装文件，提升小块读取效率（尤其机械盘）
• 不要忽略 io.Copy 的返回值错误，比如磁盘满、权限不足、中断等都会在这里暴露

file, _ := os.Open("large.zip")
defer file.Close()

h := md5.New()
io.Copy(h, file) // 自动分块读取并写入 h

hashStr := hex.EncodeToString(h.Sum(nil)[:])

sha256.File() 不存在，别搜错函数名

Golang 标准库中没有类似 Python 的 hashlib.sha256().update().hexdigest() 链式调用，更没有 sha256.File() 这样的便捷函数。所有哈希计算都基于 hash.Hash 接口，必须手动管理文件读取和写入流程。

• 常见误搜关键词如 “golang sha256 file function” 容易导向第三方包，但标准库完全够用
• 若需同时算多个哈希（如 md5 + sha256），可用 multihash 模式：创建两个 hash.Hash，用 io.MultiWriter 同时写入
• 注意 sha256.Siz

  

  e 是 32 字节，md5.Size 是 16 字节，硬编码长度时务必核对常量

校验文件一致性时，务必检查 error，且优先用 sha256

MD5 已被证实存在碰撞漏洞，不建议用于安全敏感场景（如固件签名、下载完整性校验）。生产环境应默认使用 sha256，除非协议强制要求 MD5（如某些老旧 CDN 的 ETag）。

• 校验逻辑中，os.Open、io.Copy、hex.DecodeString（比对时）三处 error 都不可忽略
• 从配置或命令行读取期望哈希值时，注意大小写：Go 的 hex.DecodeString 只接受小写，而某些系统返回大写，需先 strings.ToLower
• 若需高性能批量校验（如备份工具），可考虑 mmap + 并行分块哈希，但标准库无内置支持，需自行封装

实际用起来最易出问题的，是把哈希值当字符串直接比较却不做大小写归一化，以及忘记关文件导致后续操作失败——这两点在长时间运行的服务里尤其隐蔽。