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.Size是 32 字节，md5.Size是 16 字节，硬编码长度时务必核对常量
校验文件一致性时，务必检查 error，且优先用 sha256
MD5 已被证实存在碰撞漏洞，不建议用于安全敏感场景（如固件签名、下载完整性校验）。生产环境应默认使用 sha256，除非协议强制要求 MD5（如某些老旧 CDN 的 ETag）。
立即学习“go语言免费学习笔记（深入）”；
- 校验逻辑中，
os.Open、io.Copy、hex.DecodeString（比对时）三处 error 都不可忽略 - 从配置或命令行读取期望哈希值时，注意大小写：Go 的
hex.DecodeString只接受小写，而某些系统返回大写，需先strings.ToLower - 若需高性能批量校验（如备份工具），可考虑 mmap + 并行分块哈希，但标准库无内置支持，需自行封装
