在Golang开发中，生成MD5哈希是很多场景下的基础需求，比如验证文件完整性、对敏感数据进行简单加密存储等，标准库中的crypto/md5包已经提供了完整的实现能力，不需要引入第三方依赖就能完成哈希生成。
crypto/md5包核心方法说明
crypto/md5包的核心是md5.New()函数，它会返回一个实现了hash.Hash接口的哈希对象，我们可以通过这个对象完成数据的写入和哈希计算。常用的相关方法如下：
md5.New()：创建新的MD5哈希计算器hash.Write(p []byte)：向哈希计算器写入待计算的数据hash.Sum(b []byte) []byte：计算当前哈希值，可选参数b会追加到结果前返回
生成字符串的MD5哈希
生成字符串的MD5哈希是最常用的场景，步骤如下：首先创建MD5哈希对象，然后将字符串转换为字节数组写入哈希对象，最后调用Sum方法获取哈希结果，再转换为十六进制字符串即可。
下面是完整的实现代码：
package main
import (
"crypto/md5"
"encoding/hex"
"fmt"
)
// 生成字符串的MD5哈希
func getStringMD5(str string) string {
// 创建MD5哈希对象
hash := md5.New()
// 写入待计算的字符串字节
hash.Write([]byte(str))
// 计算哈希值并转换为十六进制字符串
return hex.EncodeToString(hash.Sum(nil))
}
func main() {
testStr := "hello golang"
md5Result := getStringMD5(testStr)
fmt.Printf("字符串：%snMD5哈希值：%sn", testStr, md5Result)
}
生成文件的MD5哈希
生成文件的MD5哈希可以用来验证文件传输过程中是否损坏，步骤是：打开目标文件，创建MD5哈希对象，使用io.Copy将文件内容写入哈希对象，最后获取哈希结果并转换格式。
具体实现代码如下：
package main
import (
"crypto/md5"
"encoding/hex"
"fmt"
"io"
"os"
)
// 生成文件的MD5哈希
func getFileMD5(filePath string) (string, error) {
// 打开文件
file, err := os.Open(filePath)
if err != nil {
return "", err
}
defer file.Close()
// 创建MD5哈希对象
hash := md5.New()
// 将文件内容拷贝到哈希对象
_, err = io.Copy(hash, file)
if err != nil {
return "", err
}
// 计算哈希值并转换为十六进制
return hex.EncodeToString(hash.Sum(nil)), nil
}
func main() {
filePath := "./test.txt"
md5Result, err := getFileMD5(filePath)
if err != nil {
fmt.Printf("生成文件MD5失败：%vn", err)
return
}
fmt.Printf("文件路径：%snMD5哈希值：%sn", filePath, md5Result)
}
注意事项
在使用crypto/md5生成哈希时，需要注意以下几点：
- MD5属于弱哈希算法，已经不推荐用于密码存储等安全场景，仅适合做数据校验、非安全类的哈希标识
- 哈希计算时写入的数据顺序会影响最终结果，相同数据顺序一致才能得到相同哈希
- 如果需要多次复用哈希对象，计算完一次哈希后需要调用
hash.Reset()方法重置状态，否则后续计算结果会包含之前的数据
常见问题解答
为什么Sum方法传入nil也能正常工作
Sum方法的参数b是用来追加到哈希结果前的字节，如果不需要追加额外内容，传入nil即可，方法会直接返回计算得到的哈希字节数组。
哈希结果的大小写有区别吗
MD5哈希的十六进制表示通常默认是小写，但是哈希值本身是无符号字节数组，大小写转换不影响哈希的实际含义，只是展示形式不同，使用时保持统一即可。
Golangcrypto/md5MD5哈希哈希生成修改时间：2026-06-12 03:03:26