Golang实现ZIP压缩解压工具教程

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《Golang 实现 zip 文件压缩解压工具》，聊聊，我们一起来看看吧！

使用Golang的archive/zip包可轻松实现文件压缩解压。首先通过os.Create创建目标ZIP文件，再用zip.NewWriter生成写入器，遍历源文件并调用FileInfoHeader获取文件头，利用filepath.ToSlash确保路径兼容性，普通文件需读取内容写入ZIP，目录则创建对应条目；解压时用zip.OpenReader打开压缩包，遍历其中文件，检查路径合法性防止穿越攻击，目录直接创建，文件则逐个解压到指定位置，并注意关闭资源；实际应用中建议设置压缩级别、流式处理大文件、添加进度提示与错误处理，确保工具稳定安全。

用 Golang 做一个文件压缩解压工具并不复杂，标准库中的 archive/zip 包提供了完整的支持。通过它，你可以轻松实现文件的打包、压缩、解压和读取操作。下面结合实际项目场景，一步步带你使用 zip 包完成常见功能。

创建 ZIP 压缩文件

要将一个或多个文件压缩成 ZIP 包，需要创建一个 zip.Writer，然后逐个写入文件内容。

基本步骤：

• 打开目标 ZIP 文件（os.Create）
• 用 zip.NewWriter 创建写入器
• 遍历待压缩的文件路径，逐个添加到 ZIP 中
• 每个文件需创建 zip.FileHeader，并写入原始数据
• 记得关闭 writer 和文件句柄

func compressFile(src, dst string) error {
    outFile, err := os.Create(dst)
    if err != nil {
        return err
    }
    defer outFile.Close()

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

    return filepath.Walk(src, func(path string, info os.FileInfo, err error) error {
        if err != nil {
            return err
        }

        header, _ := zip.FileInfoHeader(info)
        header.Name = filepath.ToSlash(path[len(src):]) // 保持相对路径

        if info.IsDir() {
            header.Name += "/"
            zipWriter.CreateHeader(header)
            return nil
        }

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

        content, err := os.ReadFile(path)
        if err != nil {
            return err
        }
        _, err = writer.Write(content)
        return err
    })
}

解压 ZIP 文件

解压的核心是读取 ZIP 包中的每个文件，并还原到指定目录。

关键点：

• 使用 zip.OpenReader 打开 ZIP 文件
• 遍历其中的 *zip.File 对象
• 如果是目录，创建对应文件夹
• 如果是普通文件，读取内容并写入本地
• 注意处理路径安全问题，避免路径穿越攻击

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

    for _, file := range reader.File {
        filePath := filepath.Join(dest, file.Name)

        // 防止路径穿越
        if !strings.HasPrefix(filePath, filepath.Clean(dest)+string(os.PathSeparator)) {
            return fmt.Errorf("invalid file path: %s", filePath)
        }

        if file.FileInfo().IsDir() {
            os.MkdirAll(filePath, os.ModePerm)
            continue
        }

        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
        }

        io.Copy(outFile, inFile)

        outFile.Close()
        inFile.Close()
    }
    return nil
}

实用技巧与注意事项

在真实项目中，除了基础功能，还需要考虑健壮性和用户体验。

• 压缩时可以设置压缩级别：zip.Deflate 使用更好的压缩算法
• 大文件建议使用流式读写，避免内存溢出
• 解压前校验目标路径是否合法，防止恶意 ZIP 文件破坏系统
• 可加入进度反馈，尤其是处理大量文件时
• 跨平台路径分隔符统一用 filepath.ToSlash 处理

基本上就这些。Golang 的 zip 包设计简洁，配合 filepath 和 io 操作就能构建出稳定可靠的压缩工具。不复杂但容易忽略细节，比如权限保留、错误处理和资源释放。实际项目中建议封装成通用函数，并加上测试用例验证边界情况。

终于介绍完啦！小伙伴们，这篇关于《Golang实现ZIP压缩解压工具教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！