gzip压缩字节流而非Go代码本身,需先用gofmt.Source格式化获取[]byte,再交由gzip.Writer压缩;必须调用gz.Close()写入CRC和ISIZE,否则解压失败。

gzip 压缩的是字节流,不是“格式化后的 Go 代码”本身——你得先拿到格式化后的 []byte 或 io.Reader,再喂给 gzip.Writer。Go 标准库没有「一键格式化+压缩」函数,必须分两步:格式化 → 获取字节 → 压缩。
用 gofmt 格式化后再压缩字节流
常见场景是:读一个 .go 文件,gofmt 整理后直接压缩进 .gz,不落地中间文件。
-
gofmt.Source接收原始字节,返回格式化后的[]byte(失败时返回 error) - 别用
gofmt.Format—— 它只写到io.Writer,没法直接取结果 - 压缩前必须确保输入非空;空或只有空白的源码,
gofmt.Source可能返回原样或 error,需检查 - 压缩后务必调用
gzWriter.Close(),否则生成的.gz文件尾部缺 CRC 和 ISIZE,gunzip -t会报unexpected end of file
src, err := os.ReadFile("main.go")
if err != nil {
return err
}
formatted, err := gofmt.Source(src)
if err != nil {
return fmt.Errorf("format failed: %w", err)
}
f, _ := os.Create("main.go.gz")
defer f.Close()
gz := gzip.NewWriter(f)
defer gz.Close() // 必须
_, err = gz.Write(formatted)
if err != nil {
return err
}
// Close() 在 defer 中触发,写入尾部元数据
压缩整个目录时,别对已压缩文件重复压
如果你在格式化一批 .go 文件后打包成 tar.gz,注意:.go 是文本,压缩收益高;但若目录里混了 .png、.jpg 或已有 .gz,再用 gzip 压一遍不仅体积不变,还可能略增(DEFLATE 对已压缩数据会 fallback 到 Store)。
- 遍历目录时,用
filepath.WalkDir检查后缀:strings.HasSuffix(name, ".go")再决定是否格式化 - 对非
.go文件,跳过gofmt.Source,直接io.Copy原始内容进tar.Writer -
tar.Writer本身不压缩,压缩由外层gzip.Writer承担,所以所有文件都走同一压缩流,无需单个判断
解压后想还原可读格式?不用额外格式化
压缩的是格式化后的字节,解压出来就是人眼可读的 Go 代码——只要当初格式化成功,且没在压缩/传输中损坏。
- 解压用
gzip.NewReader,不是直接os.Open后读二进制 - 写入目标文件前,确保父目录存在:
os.MkdirAll(filepath.Dir(dst), 0755) - 如果解压目标是
.go文件,权限建议设为0644(避免执行位干扰编辑器)
f, _ := os.Open("main.go.gz")
defer f.Close()
gr, _ := gzip.NewReader(f)
defer gr.Close()
out, _ := os.Create("main_formatted.go")
defer out.Close()
io.Copy(out, gr) // 自动处理流边界,比手写循环安全
路径和错误处理容易被忽略的点
真正出问题的地方往往不在压缩逻辑本身,而在前后链路:
立即学习“go语言免费学习笔记(深入)”;
-
gofmt.Source对语法错误的 Go 代码返回 error,但不会 panic;你得显式检查,否则静默写入未格式化的原始字节 - 压缩大文件(>100MB)时,别把整个
[]byte加载进内存;改用io.CopyBuffer+bytes.NewReader(formatted)或直接流式处理(先gofmt到io.Pipe) - Windows 路径中的
\不影响gofmt,但后续写入tar或zip时必须转成/,否则跨平台解压失败 - 最终生成的
.gz文件,用file main.go.gz应输出gzip compressed data,不是data—— 后者说明Close()没调用


















