compress/flate 仅实现 RFC 1951 DEFLATE 算法,无 gzip/zlib 封装;压缩需调用 Close() 刷新,解压输入必须是纯 DEFLATE 流,误用于 .gz 文件会报 invalid header。

Go 标准库 compress/flate 提供了对 DEFLATE 算法 的底层实现(RFC 1951),它不包含 zlib 或 gzip 头尾,仅处理纯压缩数据流。适用于需要与底层协议(如 HTTP 响应体、自定义二进制协议)对接,或需精细控制压缩参数的场景。
理解 flate 的定位:不是直接替代 gzip
compress/flate 不读写 gzip/zlib 封装格式(即没有魔数、CRC、长度字段等)。如果你拿到的是 .gz 文件或带 gzip header 的 HTTP body,应使用 compress/gzip;若你只有一段原始字节,想用 DEFLATE 压缩/解压,且后续要手动拼接头尾或嵌入到其他协议中,才用 flate。
常见误用:试图用 flate.NewReader 解压一个 .gz 文件 → 报错 invalid header,因为缺少 gzip header。
压缩二进制数据:创建 flate.Writer
使用 flate.NewWriter 包裹一个 io.Writer,然后写入原始字节。关键点:
立即学习“go语言免费学习笔记(深入)”;
- 压缩级别通过
flate.BestSpeed、flate.BestCompression、flate.DefaultCompression或 0–9 的整数指定 - 必须调用
w.Close()才能刷新并写出最终压缩块(否则部分数据可能滞留在缓冲区) - 输出是纯 DEFLATE 流,无额外封装
示例:
data := []byte("hello world, this is binary data")
var buf bytes.Buffer
w, _ := flate.NewWriter(&buf, flate.BestCompression)
w.Write(data)
w.Close() // 必须调用!
compressed := buf.Bytes() // []byte,纯 DEFLATE 数据
解压二进制数据:使用 flate.NewReader
flate.NewReader 接收一个 io.Reader,返回一个可读取原始数据的接口。注意:
- 输入必须是合法的 DEFLATE 流(不能是 gzip/zlib)
- 不需要显式 Close,但建议在用完后调用
r.(io.Closer).Close()释放资源(尤其在长期运行服务中) - 如果输入损坏或非 DEFLATE 格式,
Read会返回错误(如unexpected EOF、invalid literal/length code)
示例:
r := flate.NewReader(bytes.NewReader(compressed))
defer func() { _ = r.(io.Closer).Close() }()
var dst bytes.Buffer
io.Copy(&dst, r) // 自动解压并写入
original := dst.Bytes() // 应等于初始 data
进阶:复用 Writer/Reader 避免频繁分配
在高频压缩/解压场景(如 HTTP 中间件),可复用 flate.Writer 和 flate.Reader 实例以减少内存分配:
- Writer 支持
w.Reset(io.Writer)重置目标;也可传入预分配的bytes.Buffer并复用其底层数组 - Reader 没有 Reset 方法,但可重复调用
flate.NewReader—— 它内部已做轻量初始化,开销可控;若极致优化,可结合sync.Pool缓存 Reader 实例
小提示:DEFLATE 压缩效果高度依赖数据特征。对已经压缩过的数据(如 JPEG、MP4)、加密随机数据,flate 基本无法进一步压缩,甚至可能略微膨胀。










