Go中压缩文件需用gzip.NewWriter包装目标文件,通过io.Copy写入并必须调用gzw.Close();可选设置Header.Name和ModTime保留原名与时间戳,并应校验Close()错误及输出文件有效性。

在 Go 中使用 compress/gzip 压缩文件,核心是将文件内容写入一个 gzip writer,再保存为 .gz 文件。关键在于正确打开源文件、创建 gzip 写入器、复制数据,并及时关闭资源。
压缩单个文件为 .gz 格式
这是最常见需求:读取一个普通文件(如 data.txt),生成对应的 data.txt.gz。
- 用
os.Open打开源文件,os.Create创建目标 .gz 文件 - 用
gzip.NewWriter包装目标文件句柄,得到可写的 gzip 流 - 用
io.Copy将源文件内容流式写入 gzip writer -
必须调用
gzw.Close()—— 否则压缩头/尾可能不完整,解压会失败
保留原始文件名和修改时间(可选增强)
默认 gzip 文件不记录原始文件名和时间戳。若需兼容传统工具(如 Linux gunzip -l 显示原名),可设置 Header:
- 创建
gzip.Writer后,修改其Header.Name字段(如设为"data.txt") - 通过
os.Stat获取源文件的ModTime(),赋给Header.ModTime - 注意:
Name是 UTF-8 字符串,不能含路径(只留文件名)
压缩后校验与错误处理
生产环境建议加入基础检查:
立即学习“go语言免费学习笔记(深入)”;
- 检查
io.Copy返回的字节数是否等于源文件大小(可选,用于确认无截断) - 捕获
gzw.Close()的 error —— 它会触发实际压缩和写入 footer,可能失败(如磁盘满) - 压缩完成后,可用
os.Stat验证目标文件是否存在且大小 > 0
简单示例代码(可直接运行)
// compress.go
package main
import (
"os"
"io"
"os/exec"
"compress/gzip"
"fmt"
)
func main() {
src, err := os.Open("input.txt")
if err != nil {
panic(err)
}
defer src.Close()
dst, err := os.Create("input.txt.gz")
if err != nil {
panic(err)
}
defer dst.Close()
gzw := gzip.NewWriter(dst)
// 可选:添加原始文件名和时间
if info, _ := src.Stat(); info != nil {
gzw.Header.Name = info.Name()
gzw.Header.ModTime = info.ModTime()
}
if _, err := io.Copy(gzw, src); err != nil {
panic(err)
}
if err := gzw.Close(); err != nil {
panic(err)
}
fmt.Println("压缩完成:input.txt.gz")
}
不复杂但容易忽略










