gzip.Writer写入后必须调用Close()才能写出完整压缩流，否则缺少尾部导致解压失败；gzip.Reader要求输入为完整合法gzip流，否则初始化即报错；HTTP中启用gzip需手动压缩并设置Content-Encoding且删除Content-Length。
gzip.Writer 写入时必须调用 Close() 才能写出完整压缩流
很多初学者用 gzip.Writer 写完数据就直接丢弃，结果解压失败或只得到部分数据。这是因为 gzip.Writer 内部有缓冲区，Write() 只把数据塞进缓冲区，真正的压缩和写入头/尾部（如 CRC、ISIZE）发生在 Close() 时。
- 不调用
Close()→ 输出文件缺少 gzip 尾部，gunzip报invalid compressed data--format violated - 用
defer w.Close()是安全习惯，但要注意：如果w.Close()返回 error，它可能包含真实写入失败（比如磁盘满），不能忽略 - 若需在关闭前获取底层
io.Writer的错误（例如写入网络连接失败），应先Flush()，再Close()
fw, _ := os.Create("out.gz")
gz := gzip.NewWriter(fw)
gz.Write([]byte("hello world"))
// ❌ 缺少这行会导致 gzip 流不完整
gz.Close() // ✅ 必须调用
fw.Close()
gzip.Reader 要求输入是完整、合法的 gzip 格式字节流
gzip.Reader 不是“流式容忍型”解压器——它会在初始化时读取并校验 gzip header 和尾部（ISIZE）。如果传入的是截断的、拼接的或非 gzip 开头的字节流，会立即返回 error。
- 常见错误：
gzip: invalid checksum或gzip: invalid header，往往是因为源数据被截断、或混入了其他协议头（如 HTTP chunked 编码未剥离） - 从
http.Response.Body读 gzip 数据时，确保resp.Header.Get("Content-Encoding") == "gzip"，且没被中间件提前解压 - 若需处理不完整流（如实时日志压缩流），不要直接用
gzip.Reader，改用zlib.NewReader或分块解析逻辑
fr, _ := os.Open("in.gz")
gr, err := gzip.NewReader(fr)
if err != nil {
log.Fatal(err) // 如 err == gzip: invalid header，说明 fr 不是 gzip 文件
}
defer gr.Close()
data, _ := io.ReadAll(gr) // ✅ 此时才真正解压
设置 gzip.Writer 的 Level 和 Name 字段影响兼容性与元数据
gzip.Writer 支持配置压缩级别和可选的文件名字段，这些不是纯性能开关，而是影响生成流的语义和跨平台行为。
-
gzip.BestSpeed到gzip.BestCompression影响 CPU/时间权衡，但gzip.DefaultCompression（=6）是大多数场景的合理起点 - 设置
Header.Name（如gz.Header.Name = "data.json"）会让输出包含原始文件名，某些解压工具（如gunzip -l）会显示它；但多数 Go 程序读取时不依赖该字段 - 若目标系统是嵌入式或旧版 BusyBox，避免设
Header.ModTime为零值以外的时间——某些精简实现会因时间戳解析失败而拒绝解压
gz := gzip.NewWriter(fw) gz.Header.Name = "config.yaml" // 可选，仅作提示用 gz.Header.Comment = "auto-generated" gz.Level = gzip.BestCompression gz.Write(data) gz.Close()
HTTP 响应中启用 gzip 需手动控制 Content-Encoding 和 Transfer-Encoding
Go 的 net/http 默认不自动压缩响应体。即使客户端发了 Accept-Encoding: gzip，服务端也必须显式压缩并设置响应头，否则浏览器收不到有效 gzip 流。
立即学习“go语言免费学习笔记（深入）”；
- 不能只写
Content-Encoding: gzip而不实际压缩数据，否则浏览器会尝试解压明文，报错ERR_CONTENT_DECODING_FAILED - 若使用
http.ResponseWriter，需包装其Write()方法，或用中间件（如golang.org/x/net/http2/h2c不适用此场景） - 注意：压缩后响应体长度未知，要禁用
Content-Length，让 HTTP/1.1 自动转为chunked编码；否则浏览器等待超时
func handler(w http.ResponseWriter, r *http.Request) {
if !strings.Contains(r.Header.Get("Accept-Encoding"), "gzip") {
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(data)
return
}
w.Header().Set("Content-Encoding", "gzip")
w.Header().Del("Content-Length") // ⚠️ 必须删除，否则 chunked 失效
gz := gzip.NewWriter(w)
defer gz.Close()
json.NewEncoder(gz).Encode(data)
}
实际用 gzip 时最常卡住的不是语法，而是「谁负责 Close」「输入是否真为 gzip」「Content-Encoding 和真实字节是否匹配」这三个点。只要盯紧这三处，90% 的问题就消掉了。 
