gzip.writer 无 writeheader() 方法；关键在 close() 后不可再写，未 close 则缓冲区不刷新致解压失败；zstd 复用可降 30%~60% cpu，须用 sync.pool 管理并正确 reset/close。
gzip.WriteHeader() 调用后不能再写入数据？
不是 gzip.WriteHeader() —— 这个函数根本不存在。Go 标准库的 gzip.Writer 没有类似 HTTP 的 Header 机制，常见错误是误把 http.ResponseWriter.WriteHeader() 的逻辑套过来，结果发现压缩流提前关闭或 panic。
真正关键的是：一旦调用 gzip.Writer.Close()，底层 io.Writer 就被封住，再写会报 write: invalid argument 或静默丢弃。而没 Close 就直接丢弃 gzip.Writer，会导致最后一块缓冲区没 flush，解压时提示 “unexpected EOF”。
- 务必在所有
Write()完成后显式调用Close() - 如果要中途 abort，用
Reset()重置内部状态（但需注意它不重置底层 writer） - 别依赖 defer Close() 在 error 分支里——出错时可能已经部分写入，需要先
Reset()再处理
zstd.Encoder 复用比创建新实例快多少？
复用 zstd.Encoder 实例能省掉初始化字典、分配哈希表和滑动窗口内存的成本，在高频小数据压缩场景下，实测可减少 30%~60% CPU 时间。但前提是复用方式正确：不能跨 goroutine 并发写同一个 encoder（它不是并发安全的），也不能在 Reset 前未 Close 导致内存泄漏。
标准做法是用 sync.Pool 管理：
立即学习“go语言免费学习笔记（深入）”；
var zstdPool = sync.Pool{
New: func() interface{} {
return zstd.NewWriter(nil, zstd.WithEncoderLevel(zstd.SpeedDefault))
},
}
- 每次从 pool 取出后必须调用
Reset(w io.Writer)绑定新目标 writer - 用完立刻
Close()（不是Reset()）再放回 pool，否则下次取出时内部状态混乱 - 如果 writer 是网络连接（如
net.Conn），注意Reset()不会清空已写入缓冲区，需确保上层协议无粘包风险
gzip 和 zstd 在小文件（
小于 1KB 的数据，gzip 压缩后反而可能变大（因 header 占 10+ 字节 + DEFLATE 最小块开销），而 zstd 的 WithEncoderLevel(zstd.SpeedFastest) 在 256B 输入时仍能保持 0.5x 压缩率，且编码耗时比 gzip 低 40%。
但要注意：zstd 默认启用帧头校验，对极短数据（如 32B JSON）加 12 字节 overhead；若确定传输链路可靠，可用 zstd.WithNoEntropy 关闭 CRC，进一步减小体积。
- gzip 最适合 4KB+ 数据，尤其文本类；低于 1KB 优先试 zstd + SpeedFastest
- zstd 的
SpeedBestCompression对小数据收益极低，压缩时间翻倍但体积只少 2~3% - 别在 HTTP 响应头里硬写
Content-Encoding: zstd—— 浏览器不支持，服务端需按 Accept-Encoding 动态降级
为什么 zstd.Decoder 解压失败却没报错？
zstd.Decoder.DecodeAll() 或 Read() 返回 nil 错误不代表数据完整解压成功。zstd 允许输入流末尾有填充字节或非标准帧，Decoder 默认静默跳过；只有遇到真正无法识别的格式（如 magic number 错）才报错。
更隐蔽的问题是：Decoder 复用时未调用 Reset()，导致残留的上一次字典或窗口状态污染本次解压，输出乱码但无 panic。
- 用
zstd.Decoder.Reset(r io.Reader)替代新建实例，但必须确保r是 seekable 或明确知道从头开始 - 验证解压结果长度是否符合预期（比如原始 size 存在 header 里），不要只信 error == nil
- 线上环境建议开启
zstd.WithDecoderAllowNonCanonical()避免因上游 bug 产生的非标帧直接 crash
