MD5是一种广泛使用的哈希算法，能把任意长度的数据映射成128位（16字节）的固定长度摘要。在Golang中，标准库自带了crypto/md5包，不需要引入任何第三方依赖就能直接使用。虽然MD5在安全领域已经不再推荐用于加密场景，但在数据校验、缓存键生成、文件去重等非安全场景中依然非常常见。本文将系统地介绍crypto/md5包的使用方法，包括字符串哈希、文件哈希、流式计算以及格式化输出的各种技巧。
一、crypto/md5包的基础用法
crypto/md5包对外暴露的核心函数是md5.Sum，它接收一个字节切片，返回一个16字节的[16]byte数组。这个函数适合处理能一次性读入内存的数据，比如短字符串、配置内容等。下面是一个最基础的例子：
package main
import (
"crypto/md5"
"encoding/hex"
"fmt"
)
func main() {
data := []byte("hello world")
sum := md5.Sum(data)
// sum 是 [16]byte 数组，转成切片后用十六进制编码
hashStr := hex.EncodeToString(sum[:])
fmt.Println(hashStr) // 5eb63bbbe01eeed093cb22bb8f5acdc3
}
这段代码有几个值得注意的细节。第一，md5.Sum的参数类型是[]byte，所以字符串需要先用[]byte()做一次转换。第二，返回值是数组而不是切片，直接传给hex.EncodeToString会报类型错误，必须用sum[:]把它转成切片。第三，如果只是用fmt.Printf("%x", sum)输出，也能直接得到十六进制字符串，%x动词对字节数组会自动按十六进制逐字节输出。
实际项目中经常需要封装一个工具函数，统一返回字符串形式的哈希值。可以这样写：
func MD5Hex(s string) string {
sum := md5.Sum([]byte(s))
return hex.EncodeToString(sum[:])
}
这种封装的好处是调用方拿到的永远是64字符的规范格式（准确说是32个十六进制字符），避免各处代码各自格式化导致大小写不统一的问题。需要注意的是hex.EncodeToString输出的是小写，如果业务上要求大写，可以再用strings.ToUpper处理一次。
二、使用md5.New实现流式计算
md5.Sum的缺点是必须把全部数据放在内存里。如果要处理一个几百MB甚至几GB的大文件，一次性读入内存显然不现实。这时应该用md5.New()创建一个哈希对象，它实现了hash.Hash接口，而这个接口又实现了io.Writer，可以分多次写入数据，最后调用Sum方法获取最终摘要。
package main
import (
"crypto/md5"
"encoding/hex"
"fmt"
"io"
"os"
)
func FileMD5(path string) (string, error) {
file, err := os.Open(path)
if err != nil {
return "", err
}
defer file.Close()
h := md5.New()
if _, err := io.Copy(h, file); err != nil {
return "", err
}
return hex.EncodeToString(h.Sum(nil)), nil
}
func main() {
hash, err := FileMD5("test.zip")
if err != nil {
panic(err)
}
fmt.Println("文件MD5:", hash)
}
这个例子的关键在于io.Copy(h, file)。io.Copy内部会使用32KB的缓冲区分块读取文件内容并写入哈希对象，全程内存占用非常稳定，无论文件多大都不会出现内存暴涨。h.Sum(nil)的作用是返回当前哈希值，参数nil表示让函数自己分配结果切片。这一点容易搞混：参数传进去的字节切片是用于追加结果的缓冲区，而不是参与哈希计算的数据。
hash.Hash接口还有一个Reset方法，调用后哈希对象会回到初始状态，可以复用来计算下一个数据的哈希值，避免重复分配内存。在需要批量计算的场景下，比如遍历目录给所有文件生成指纹，复用哈希对象能带来可观的性能提升。
三、MD5的安全性问题与替代方案
必须明确一点：MD5早在2004年就被证明存在碰撞漏洞，攻击者可以构造出两个不同内容但MD5值相同的文件。因此任何涉及密码存储、数字签名、防篡改的场景，都绝对不能使用MD5。特别提醒一点，直接用MD5存储用户密码即使加了固定盐也是不安全的，因为MD5计算速度极快，攻击者可以用GPU每秒尝试数十亿次碰撞。密码存储应该使用专门的慢哈希算法，比如标准库golang.org/x/crypto/bcrypt提供的bcrypt。
对于需要抗碰撞的通用哈希场景，Golang标准库提供了crypto/sha256和crypto/sha512，用法与crypto/md5完全一致，只是把导入包换掉即可：
package main
import (
"crypto/sha256"
"encoding/hex"
"fmt"
)
func main() {
data := []byte("hello world")
sum := sha256.Sum256(data)
fmt.Println(hex.EncodeToString(sum[:]))
// b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9
}
那MD5如今还有什么存在价值呢？主要是性能和兼容性。MD5的计算速度比SHA256快，在非对抗性场景下，比如判断文件传输是否完整、为缓存生成键、做内容去重的初步筛选，MD5依然够用。另外大量遗留系统和第三方接口仍在使用MD5作为校验算法，对接时不得不支持。
总结一下使用建议：涉及安全就选SHA256或更强的算法；纯校验和缓存场景用MD5没问题；处理大文件记得走io.Copy流式计算的路子；输出统一用hex.EncodeToString格式化，保持工程内一致性。掌握这几个要点，就能在Golang中正确高效地使用哈希算法了。
Golangcrypto/md5哈希修改时间：2026-09-03 17:46:45