Go语言标准库archive/zip实现文件压缩与解压完整指南

准备条件与环境配置

Go 语言的标准库已包含对多种压缩格式的支持，其中针对 ZIP 格式的读写功能位于 archive/zip 包中。要执行相关操作，只需在 Go 源代码的导入部分引用该包即可：

import "archive/zip"

无需额外安装第三方包，这保证了程序的可移植性和轻量级。此外，读写过程中通常需要配合 io、os 及 bytes 等标准库完成文件的打开、关闭与数据流传输。

创建 ZIP 压缩文件

创建一个 ZIP 文件的核心逻辑是建立压缩 writer 实例，将目标文件的内容写入内部，最后关闭 writer 以生成有效的归档头尾信息。

第1步：初始化缓冲区与 Writer

为灵活处理压缩后的二进制数据，通常先使用 bytes.Buffer 作为中转容器，再利用 zip.NewWriter() 创建 writer 对象。此步骤用于在内存中暂存未落盘的压缩数据。

第2步：添加文件条目并写入数据

循环调用 writer 的 Create(name) 方法为每个待压缩文件创建条目。Create 返回一个 io.WriteCloser 接口，向其写入具体字节后即可视为该文件写入完成。建议对每一步错误进行判断，确保数据写入成功。

第3步：保存结果到磁盘

完成所有文件写入后，务必调用 w.Close() 刷新数据并更新 ZIP 文件的尾部信息。随后使用 os.Create 或 os.OpenFile 打开本地磁盘路径，将 Buffer 中的内容输出保存。

完整的 Go 语言创建 ZIP 文件代码如下：

package main

import (
    "archive/zip"
    "bytes"
    "fmt"
    "os"
)

func main() {
    // 1. 创建一个缓冲区用来保存压缩文件内容
    buf := new(bytes.Buffer)
    
    // 2. 创建一个压缩文档
    w := zip.NewWriter(buf)
    
    // 定义需要加入的文件结构体切片
    var files = []struct {
        Name, Body string
    }{
        {"Golang.txt", "http://jb51.net/golang/"},
    }
    
    // 3. 将文件加入压缩文档
    for _, file := range files {
        f, err := w.Create(file.Name)
        if err != nil {
            fmt.Println(err)
        }
        _, err = f.Write([]byte(file.Body))
        if err != nil {
            fmt.Println(err)
        }
    }
    
    // 4. 关闭压缩文档，这一步至关重要，会写入ZIP结束记录
    err := w.Close()
    if err != nil {
        fmt.Println(err)
    }
    
    // 5. 将压缩文档内容从内存写入本地文件
    f, err := os.OpenFile("file.zip", os.O_CREATE|os.O_WRONLY, 0666)
    if err != nil {
        fmt.Println(err)
    }
    defer f.Close()
    
    buf.WriteTo(f)
}

运行上述代码后，当前目录下将生成 file.zip 文件，解包后可看到包含指定的文本内容。

读取并解压 ZIP 归档文件

读取 ZIP 归档文件需要使用 zip.OpenReader() 函数获取只读模式下的 Reader 对象。该对象的 File 字段是一个包含所有归档项的切片，通过对该切片进行迭代，可以实现批量解压或查看文件内容。

第1步：打开归档并初始化读取

调用 zip.OpenReader(archivePath) 打开目标 ZIP 文件。获取 r *Reader 后，必须使用 defer r.Close() 确保资源最终被释放。

第2步：遍历文件列表

通过 for _, f := range r.File 循环访问 ZIP 内的每一个物理文件。在此阶段可以检查文件名是否符合预期目录结构，或者过滤掉特定的隐藏文件。

第3步：打开文件流并提取内容

在循环中调用 f.Open() 获取对应文件的只读流（io.ReadCloser）。对于需要将内容打印到控制台的场景，可结合 io.CopyN 或直接使用 io.ReadAll 将数据读出。读取完毕后记得调用文件流的 Close() 方法释放底层连接。

以下代码演示了如何逐一读取 ZIP 内部所有文件的内容并输出到控制台：

package main

import (
    "archive/zip"
    "fmt"
    "io"
    "os"
)

func main() {
    // 打开一个zip格式文件
    r, err := zip.OpenReader("file.zip")
    if err != nil {
        fmt.Printf("Error opening zip: %v\n", err.Error())
        return
    }
    defer r.Close()

    // 迭代压缩文件中的文件，读取并打印出文件中的内容
    for _, f := range r.File {
        fmt.Printf("文件名: %s\n", f.Name)
        
        rc, err := f.Open()
        if err != nil {
            fmt.Printf("Error opening file inside zip: %v\n", err.Error())
            continue
        }
        
        // 将文件内容复制到标准输出
        _, err = io.Copy(os.Stdout, rc)
        if err != nil {
            fmt.Printf("Error copying file content: %v\n", err.Error())
        }
        
        rc.Close()
        fmt.Println() // 输出空行分隔不同文件内容
    }
}

运行此脚本的输出结果如下：

文件名: Golang.txt
http://jb51.net/golang/

若归档内包含深层目录结构（如 a/b/c.txt），在将文件还原到本地硬盘时，开发者需手动使用 filepath 包解析文件名的目录层级，并使用 os.MkdirAll 提前创建对应文件夹，以防出现无法写入的错误。以上就是Go语言实现zip文件创建与读取操作的详细内容，更多关于Go语言压缩技术趋势的资料请关注本站其它相关文章！