Golangzip库实现文件压缩解压教程

本文将详细介绍如何在 Golang 中利用标准库 `archive/zip` 实现 ZIP 文件的压缩与解压功能。无需额外依赖，`archive/zip` 包即可满足大多数基础的 ZIP 文件处理需求。我们将深入探讨如何创建 ZIP 压缩文件，包括创建文件、初始化写入器、遍历源文件并添加到 ZIP 中。同时，还将讲解如何解压 ZIP 文件，涵盖打开 ZIP 文件、遍历条目、根据条目类型创建目录或写入文件等关键步骤。此外，本文还会重点提示使用 `archive/zip` 包时需要注意的路径安全、权限控制、压缩级别限制以及大文件处理等问题，助你避免潜在的安全隐患，编写更健壮的 Golang 代码。掌握这些技巧，即可轻松应对 Golang 项目中的文件压缩与解压任务。

在 Go 中使用 archive/zip 包可实现 ZIP 文件的压缩和解压。1. 创建 ZIP 文件需依次创建文件、初始化写入器、遍历源文件并添加至 ZIP；2. 解压 ZIP 需打开 ZIP 文件、遍历条目并根据类型创建目录或写入文件；3. 注意路径安全、权限控制、压缩级别限制及大文件处理。上述方法适用于大多数基础场景，但需注意资源释放与路径校验以避免安全隐患。

在 Golang 中，如果你需要对文件进行压缩或解压操作，最常用的方式就是使用标准库中的 archive/zip 包。它不需要额外依赖，直接可用，适合大多数基本的 ZIP 文件处理需求。

下面我们就来看看如何用这个包实现常见的压缩和解压功能。

如何创建一个 ZIP 压缩文件

要压缩文件，核心是使用 zip.Create() 创建 ZIP 文件，然后逐个添加文件进去。大致步骤如下：

• 创建目标 ZIP 文件
• 使用 zipWriter := zip.NewWriter(file) 初始化写入器
• 遍历需要压缩的文件，为每个文件创建一个 zip.FileHeader
• 打开源文件并复制内容到 ZIP 写入器中

func compressFiles(zipPath string, filesToCompress []string) error {
    newZipFile, err := os.Create(zipPath)
    if err != nil {
        return err
    }
    defer newZipFile.Close()

    zipWriter := zip.NewWriter(newZipFile)
    defer zipWriter.Close()

    for _, filename := range filesToCompress {
        fileToZip, err := os.Open(filename)
        if err != nil {
            return err
        }
        defer fileToZip.Close()

        // 获取文件信息，用于构造 ZIP 条目
        info, err := fileToZip.Stat()
        if err != nil {
            return err
        }

        header, err := zip.FileInfoHeader(info)
        if err != nil {
            return err
        }

        // 设置压缩方式
        header.Method = zip.Deflate

        writer, err := zipWriter.CreateHeader(header)
        if err != nil {
            return err
        }

        _, err = io.Copy(writer, fileToZip)
        if err != nil {
            return err
        }
    }
    return nil
}

这里需要注意的是，header.Name 默认是从路径中提取的文件名。如果你想改变 ZIP 里的路径结构，可以手动设置 header.Name 的值。

如何解压一个 ZIP 文件

解压的过程相对简单一些：打开 ZIP 文件、遍历其中的条目，然后依次读取并写入本地磁盘。

• 使用 zipReader, _ := zip.OpenReader(path) 打开 ZIP 文件
• 遍历 zipReader.File 中的每一个条目
• 如果是目录，就创建对应目录；如果是文件，就打开并写入数据

func extractZip(zipPath string, targetDir string) error {
    reader, err := zip.OpenReader(zipPath)
    if err != nil {
        return err
    }
    defer reader.Close()

    for _, f := range reader.File {
        path := filepath.Join(targetDir, f.Name)

        if f.FileInfo().IsDir() {
            os.MkdirAll(path, os.ModePerm)
            continue
        }

        if err := os.MkdirAll(filepath.Dir(path), os.ModePerm); err != nil {
            return err
        }

        rc, err := f.Open()
        if err != nil {
            return err
        }
        defer rc.Close()

        outFile, err := os.OpenFile(path, os.O_WRONLY|os.O_CREATE|os.O_TRUNC, f.Mode())
        if err != nil {
            return err
        }
        defer outFile.Close()

        io.Copy(outFile, rc)
    }
    return nil
}

这段代码能处理 ZIP 中包含目录结构的情况。注意，在打开 ZIP 文件条目时，要记得关闭资源（比如 rc.Close()），避免资源泄露。

注意事项与常见问题

• 路径问题：ZIP 文件中的路径可能带有前缀或者层级结构，解压时如果不做处理可能会覆盖当前目录之外的内容。建议在解压前校验路径是否合法，防止“路径穿越”。
• 权限问题：压缩和解压都需要对目标路径有写权限，否则会报错。
• 压缩级别控制：archive/zip 默认使用 Deflate 算法，但不支持设置压缩等级，如需更高级别的控制，可以考虑第三方库。
• 大文件处理：如果压缩或解压的是非常大的文件，建议使用流式处理，避免一次性加载全部内容导致内存占用过高。

基本上就这些。用 Go 标准库 archive/zip 实现 ZIP 文件的压缩和解压并不复杂，但在实际项目中要注意细节处理，比如路径安全、资源释放等。对于一般用途来说，这套方法已经足够实用了。

理论要掌握，实操不能落！以上关于《Golangzip库实现文件压缩解压教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！