本文详解 go 中使用 `crypto/sha1` 计算文件 sha1 哈希时常见错误——尤其是空文件场景下哈希不匹配 openssl 的根本原因，并提供可直接运行的正确实现。
在 Go 中调用 crypto/sha1 计算哈希时，一个典型误区是误将字节切片内容等同于文件内容。例如，执行 touch test.txt 创建的是长度为 0 的空文件，其 SHA1 值应为标准的 da39a3ee5e6b4b0d3255bfef95601890afd80709（即空输入的 SHA1）。但若在代码中写入 hash.Write([]byte{0x00})，实际计算的是单字节 \x00 的哈希（结果为 5ba93c9db0cff93f52b521d7420e43f6eda2784f），这与空文件完全无关。
✅ 正确做法是：对空文件，不调用 Write，或显式传入空切片 []byte{}（效果相同）。hash.Sum(nil) 会基于当前已写入的数据（即零字节）完成最终计算：
package main
import (
"crypto/sha1"
"fmt"
)
func main() {
hash := sha1.New()
// ✅ 空文件对应零次 Write —— 无需任何输入
// hash.Write([]byte{}) // 也可显式写入空切片（效果等价）
result := hash.Sum(nil)
fmt.Printf("Empty file SHA1: %x\n", result) // 输出: da39a3ee5e6b4b0d3255bfef95601890afd80709
}
⚠️ 注意事项：
- hash.Write([]byte{0x00}) ≠ 空文件：它写入了 1 字节数据，哈希必然不同；
- hash.Sum(nil) 不会重置哈希器，仅返回当前摘要；如需复用 hash 实例，应调用 hash.Reset()；
- 实际读取文件时，务必使用 io.Copy 或 io.ReadFull 等流式方式，避免手动拼接字节导致遗漏或截断。
以下是一个完整、健壮的命令行 SHA1 工具示例，行为与 openssl sha1 完全一致：
package main
import (
"crypto/sha1"
"fmt"
"io"
"log"
"os"
)
func main() {
if len(os.Args) != 2 {
fmt.Fprintf(os.Stderr, "usage: %s <file>\n", os.Args[0])
os.Exit(1)
}
f, err := os.Open(os.Args[1])
if err != nil {
log.Fatal("failed to open file:", err)
}
defer f.Close()
hash := sha1.New()
if _, err := io.Copy(hash, f); err != nil {
log.Fatal("failed to read file:", err)
}
fmt.Printf("%x\n", hash.Sum(nil))
}</file>
编译运行后验证：
$ touch test.txt $ go run sha.go test.txt da39a3ee5e6b4b0d3255bfef95601890afd80709 $ openssl sha1 -hex test.txt SHA1(test.txt)= da39a3ee5e6b4b0d3255bfef95601890afd80709
二者输出完全一致。核心原则始终如一：哈希值只取决于输入字节流的内容和长度，而非文件名、权限或元数据。确保 Go 中喂给 hash.Write 的数据与 openssl 读取的原始字节完全一致，即可消除所有不匹配问题。
