Golang标准库支持zip和tar压缩解压。使用archive/zip可实现目录递归压缩与解压,需设置文件头及压缩方法;通过archive/tar结合gzip可创建和解压tar.gz文件,注意路径处理与目录创建。

在 Golang 中处理压缩文件是很多实际项目中常见的需求,比如日志归档、配置打包或文件传输。Golang 标准库提供了对 zip 和 tar 格式的支持,无需引入第三方依赖即可实现文件的压缩与解压。下面通过实战示例,带你掌握如何用 Go 实现 zip 与 tar 的压缩和解压操作。
zip 文件压缩与解压
zip 是跨平台最常用的压缩格式之一,Go 的 archive/zip 包支持读写 zip 文件。
压缩目录为 zip 文件
以下函数将指定目录递归压缩成一个 zip 文件:
立即学习“go语言免费学习笔记(深入)”;
func zipDir(source, target string) error {
zipfile, err := os.Create(target)
if err != nil {
return err
}
defer zipfile.Close()
archive := zip.NewWriter(zipfile)
defer archive.Close()
filepath.Walk(source, func(path string, info os.FileInfo, err error) error {
if err != nil {
return err
}
header, _ := zip.FileInfoHeader(info)
header.Name = strings.TrimPrefix(strings.Replace(path, source, "", -1), string(filepath.Separator))
if info.IsDir() {
header.Name += "/"
} else {
header.Method = zip.Deflate
}
writer, err := archive.CreateHeader(header)
if err != nil {
return err
}
if !info.IsDir() {
file, err := os.Open(path)
if err != nil {
return err
}
defer file.Close()
_, err = io.Copy(writer, file)
}
return err
})
return nil
}
解压 zip 文件到目标目录
下面代码将 zip 文件解压到指定路径:
func unzip(source, target string) error {
reader, err := zip.OpenReader(source)
if err != nil {
return err
}
defer reader.Close()
for _, file := range reader.File {
filePath := filepath.Join(target, file.Name)
if file.FileInfo().IsDir() {
os.MkdirAll(filePath, os.ModePerm)
} else {
if err = os.MkdirAll(filepath.Dir(filePath), os.ModePerm); err != nil {
return err
}
inFile, err := file.Open()
if err != nil {
return err
}
outFile, err := os.Create(filePath)
if err != nil {
inFile.Close()
return err
}
_, err = io.Copy(outFile, inFile)
outFile.Close()
inFile.Close()
if err != nil {
return err
}
}
}
return nil
}
tar 文件压缩与解压
tar 常用于 Linux 系统打包,通常配合 gzip 使用(.tar.gz)。Go 提供了 archive/tar 包进行处理。
创建 .tar.gz 压缩包
将目录压缩为 tar.gz 文件:
func tarGz(source, target string) error {
outfile, err := os.Create(target)
if err != nil {
return err
}
defer outfile.Close()
gzWriter := gzip.NewWriter(outfile)
defer gzWriter.Close()
tarWriter := tar.NewWriter(gzWriter)
defer tarWriter.Close()
filepath.Walk(source, func(path string, info os.FileInfo, err error) error {
if err != nil {
return err
}
header, err := tar.FileInfoHeader(info, "")
if err != nil {
return err
}
// 修正路径分隔符
header.Name = strings.TrimPrefix(strings.Replace(path, source, "", -1), string(filepath.Separator))
if err := tarWriter.WriteHeader(header); err != nil {
return err
}
if !info.IsDir() {
file, err := os.Open(path)
if err != nil {
return err
}
defer file.Close()
_, err = io.Copy(tarWriter, file)
}
return err
})
return nil
}
解压 .tar.gz 文件
从 tar.gz 解压所有内容到目标目录:
func untarGz(source, target string) error {
file, err := os.Open(source)
if err != nil {
return err
}
defer file.Close()
gzReader, err := gzip.NewReader(file)
if err != nil {
return err
}
defer gzReader.Close()
tarReader := tar.NewReader(gzReader)
for {
header, err := tarReader.Next()
if err == io.EOF {
break
}
if err != nil {
return err
}
filePath := filepath.Join(target, header.Name)
switch header.Typeflag {
case tar.TypeDir:
if _, err := os.Stat(filePath); err != nil {
os.MkdirAll(filePath, os.ModePerm)
}
case tar.TypeReg:
dir := filepath.Dir(filePath)
os.MkdirAll(dir, os.ModePerm)
out, err := os.Create(filePath)
if err != nil {
return err
}
_, err = io.Copy(out, tarReader)
out.Close()
if err != nil {
return err
}
}
}
return nil
}
使用建议与注意事项
处理压缩文件时,有几个关键点需要注意:
- 路径拼接使用 filepath.Join 避免跨平台问题
- 遍历目录时注意排除特殊文件(如 .DS_Store、符号链接等)
- 写入文件前确保父目录存在,避免报错
- 及时关闭文件句柄,推荐使用 defer
- tar 不自带压缩,需结合 gzip 才能生成 .tar.gz
对于 zip,文件头需要设置压缩方式(如 Deflate)以减小体积;tar 则直接写入原始数据流。
基本上就这些。Golang 对 zip 和 tar 的支持足够应对大多数场景,只要理解其基于流的处理逻辑,就能灵活实现各种打包解包功能。










