Go哈希需空白导入触发注册，否则crypto.Hash.Available()返回false；New()可复用，Sum256()零分配但不可复用；文件哈希优先io.Copy；MD5/SHA1仅限兼容场景；hash.Hash非并发安全。
Go 标准库的 crypto 子包提供了开箱即用的哈希能力，但直接调用常因注册缺失、错误忽略或接口误用导致结果为空、panic 或哈希值不一致——根本原因不是算法写错了，而是没让 Go “认出”你要用的算法。
为什么 crypto.Hash.Available() 返回 false？
Go 的 crypto.Hash 是一个枚举类型（uint），比如 crypto.SHA256 值为 6。但它本身不带实现；实际哈希逻辑在 crypto/sha256 等包里，而这些包的 init() 函数负责调用 crypto.RegisterHash() 把自己注册进全局表。如果你只写 import "crypto/sha256" 却没用到任何符号（如 sha256.New），Go 编译器会报错 “imported and not used”。
正确做法是空白导入：
-
_ "crypto/sha256"—— 触发注册，不引入命名空间 -
_ "crypto/md5"—— 同理，否则crypto.MD5.Available()永远返回false - 漏掉任一算法的空白导入，
GenericHash(data, crypto.SHA256)就会返回"hash algorithm not available"错误
字符串哈希：New() 和 Sum() vs Sum256() 的区别
两种写法都能得到相同结果，但行为和适用场景不同：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
-
h := sha256.New(); h.Write([]byte(s)); hex.EncodeToString(h.Sum(nil))—— 返回新分配的切片，h可复用（调用h.Reset()后继续写） -
sha256.Sum256([]byte(s)).String()—— 零分配、栈上计算，性能略高，但返回的是固定大小数组（[32]byte）的副本，无法复用 - 别混用：
sha256.Sum([]byte(s))是无效写法，正确函数名是Sum256（MD5 对应Sum，SHA256 起必须带位数后缀） - 如果做高频哈希（如日志去重），优先复用
New()实例；若只是单次计算，Sum256()更简洁
文件哈希：io.Copy 比循环 Read 更可靠
手动 Read + Write 容易遗漏 err != io.EOF 判断，或忘记处理最后一次不足缓冲区大小的读取。标准库 io.Copy 内部已处理所有边界情况。
- 必须用
os.Open（只读），而非os.OpenFile误开写权限 - 哈希对象（如
sha256.New()）实现了io.Writer，可直传给io.Copy -
io.Copy返回总字节数和 error；只要 error 为nil，就代表整个文件已完整写入哈希器 - 别在
defer f.Close()后再调用h.Sum(nil)—— Close 不影响哈希状态，但早 defer 更安全
MD5/SHA1 已不安全，但有些场景仍需兼容
区块链校验、旧协议对接、内部缓存 key 生成等场景，可能不得不支持 MD5 或 SHA1。它们在 Go 中用法一致，但要注意：
- MD5 输出 16 字节（32 位 hex），SHA1 是 20 字节（40 位 hex），SHA256 是 32 字节（64 位 hex）——长度差异会影响下游解析逻辑
-
crypto/md5包未被标记为 deprecated，但 Go 官方文档明确建议：“for security-sensitive applications, use SHA-256 or SHA-512” - 如果服务同时暴露多种哈希算法供客户端选择，务必在 API 层校验
crypto.Hash.Available()，而不是仅靠 switch 分支兜底
最易被忽略的一点：哈希对象不是并发安全的。多个 goroutine 共享同一个 hash.Hash 实例并调用 Write，结果不可预测。需要并发时，要么每次新建，要么加锁，要么用 sync.Pool 复用。
