github.com/andybalholm/brotli 是纯 Go、无 CGO 的生产级 Brotli 库,需用 brotli.NewWriter(fw, opts) 创建压缩器,显式设置 Quality(0–11)和 Window(默认22),且必须调用 w.Close() 完成流封包,否则解压失败。

用 github.com/andybalholm/brotli 写入 Brotli 压缩文件
Go 标准库不支持 Brotli,必须用第三方包;andybalholm/brotli 是目前最成熟、无 CGO 依赖的纯 Go 实现,生产可用(Loki 项目已集成),直接支持流式压缩写入文件。
关键点:它不提供类似 gzip.NewWriter 那样开箱即用的 io.Writer 封装,而是通过 brotli.Writer(注意不是 NewWriter)配合显式参数控制压缩行为。
-
brotli.Writer必须传入一个底层io.Writer(如*os.File),不能只传路径字符串 - 压缩级别用
brotli.WriterOptions{Quality: 11}控制,范围是 0–11(11 最高压缩比,也是默认值) - 窗口大小(
Window: 22)影响内存占用和压缩率,22 是默认值,对应 4MB 窗口;增大可略微提升压缩率,但内存线性增长 - 务必在写完后调用
w.Close(),否则输出不完整,解压会失败(常见错误:invalid checksum或unexpected EOF)
brotli.Writer 的典型写入流程
和 gzip 类似,但初始化方式不同:没有 NewWriter 函数,只有带选项的构造函数 brotli.NewWriter(注意拼写)——但它返回的是 *brotli.Writer,且必须传 brotli.WriterOptions。
示例代码片段:
立即学习“go语言免费学习笔记(深入)”;
fw, err := os.Create("data.br")
if err != nil {
return err
}
defer fw.Close()
// 注意:必须显式传 WriterOptions,不能省略
w := brotli.NewWriter(fw, brotli.WriterOptions{
Quality: 11,
Window: 22,
})
defer w.Close() // 这一步不可少
_, err = w.Write([]byte("hello world"))
if err != nil {
return err
}
// w.Close() 会 flush 并写入尾部元数据
- 如果只是压缩小内容,用
bytes.Buffer替代os.File也完全可行 - 不要复用同一个
*brotli.Writer多次压缩不同内容(不像gzip.Writer可 reset),每次新压缩建议新建实例 - 没有
Name、ModTime等元数据字段 —— Brotli 格式本身不携带这些信息,这点和 gzip 不同
为什么不用 golang.org/x/exp/brotli
这个包早已被标记为 deprecated,源码注释明确写着 “This package is unmaintained and should not be used.”;它只提供基础解压能力,且未实现完整压缩 API。实际项目中踩过坑的人反馈:用它压缩出的文件常被浏览器或 brotli CLI 工具拒绝识别。
- 它不支持设置
Quality或Window,压缩行为不可控 - 没有
Close()方法,无法确保尾部校验写入,导致解压失败率高 - 模块路径含
exp,说明是实验性代码,连 v0 版本都没发布
写入后如何验证是否有效
别只靠 Go 程序读取测试,要脱离 Go 生态验证:用系统级工具确认生成的是标准 Brotli 流。
- Linux/macOS 下执行:
brotli -t data.br—— 应输出OK,否则说明写入损坏 - 用
brotli -d data.br -o out.txt解压,检查内容是否一致 - 如果目标是 Web 传输,用
curl -H "Accept-Encoding: br" http://localhost/xxx配合 Wireshark 抓包,确认响应头含Content-Encoding: br且 body 可被浏览器正常解压 - 注意:Go 的
brotli.Writer默认不加任何容器封装(如 Brunsli 的 PNG 封装),输出就是裸 Brotli 流,这点和zstd或lz4的 frame 格式一致
最容易被忽略的是 w.Close() 调用时机 —— 它不只是释放资源,更是完成压缩流的封包动作;漏掉这步,90% 的“压缩成功但解压失败”问题就源于此。


















