使用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 包中的每个文件，并还原到指定目录。
立即学习“go语言免费学习笔记（深入）”；
关键点：
- 使用 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 操作就能构建出稳定可靠的压缩工具。不复杂但容易忽略细节，比如权限保留、错误处理和资源释放。实际项目中建议封装成通用函数，并加上测试用例验证边界情况。
