golang zip 中文乱码

时间：2023-05-15 07:06

随着 Golang 在 Web 开发领域的不断普及与应用，Zip 压缩文件已经成为一个必不可少的功能模块。然而，一些开发者在使用 Golang 的 Zip 包进行文件压缩时，遇到了一个常见的问题 -- 中文文件名出现乱码。

这是一个很麻烦的问题，因为它不仅让原本美观的文件名看起来不伦不类，也可能引发一系列其他错误。下面我们将探讨这个问题的原因以及解决方案。

问题的原因

Zip 格式是一种二进制格式，其中包含有文件名称、文件目录、压缩方法和压缩的数据。在这些信息中，文件名称是非常关键的一部分，因为它决定了用户在解压缩之后文件的名称和存储路径。

然而，不同的文件系统和编码格式可能导致对于同一份文件名的解析结果不同。例如，在 Windows 系统中，文件名默认使用的编码方式是 GBK，而在 UNIX/Linux 系统中，文件名使用的是 UTF-8。如果我们在使用 Golang 中的 Zip 包进行压缩时，不处理这些不同的编码方式，就可能导致文件名被当作乱码处理。

解决方案

针对中文文件名出现乱码这个问题，我们有多种解决方案。下面我们将介绍其中比较可行的几种方法。

方法一：GB18030 编码转换

因为 Zip 格式使用的是 CP437 编码来表示文件名，所以我们可以将文件名从 GB18030 编码转换成 CP437 编码，这样就能保证在任何环境下都能够正确解析文件名称。在 Go 中，可使用 golang.org/x/text/encoding/simplifiedchinese 包来进行 GB18030 编码和 CP437 编码的互转换。

import (    "golang.org/x/text/encoding/simplifiedchinese"    "golang.org/x/text/transform")func GbkToUtf8(data []byte) ([]byte, error) {    return transform.NewReader(bytes.NewReader(data), simplifiedchinese.GB18030.NewDecoder()).ReadAll()}func Utf8ToGbk(data []byte) ([]byte, error) {    return transform.NewReader(bytes.NewReader(data), simplifiedchinese.GB18030.NewEncoder()).ReadAll()}

方法二：使用 reflect

我们还可以使用 reflect 包中的 StructTag 选项，强制使用指定的编码方式。具体可以在结构体中添加 zip 的 Tag，在 Tag 中加一个 chinese-utf8 的标签就可以了。示例代码如下：

type File struct {    Name string `zip:"filename=测试文件,chinese-utf8"`}func main() {    zhName := "测试文件"    utf8Name, _ := GbkToUtf8([]byte(zhName))    f := &File{Name: string(utf8Name)}    // 压缩文件...}

方法三：使用 fileheader 和 FileInfo 中的 name 属性

在 Golang 的 Zip 包中，我们还可以通过调用 fileheader 和 FileInfo 的 name 属性来手动为每个文件指定正确的编码方式。

import "archive/zip"func zipFiles(filePaths []string, dest string) error {    // 创建文件    newZipFile, err := os.Create(dest)    if err != nil {        return err    }    defer newZipFile.Close()    // 创建 ZIP writer 对象    zipWriter := zip.NewWriter(newZipFile)    defer zipWriter.Close()    // 遍历 filePaths，为每个文件设置正确的编码方式    for _, filePath := range filePaths {        zipFile, err := os.Open(filePath)        if err != nil {            return err        }        defer zipFile.Close()        // 解析文件名，并转换编码        zipFileInfo, _ := zip.FileInfoHeader(zipFile.Stat())        zipFileInfo.Name, _ = GbkToUtf8([]byte(zipFileInfo.Name))        // 创建 Zip 文件写入器        zipWriterNewFile, err := zipWriter.CreateHeader(zipFileInfo)        if err != nil {            return err        }        // 读取文件并写入 Zip 文件中        _, err = io.Copy(zipWriterNewFile, zipFile)        if err != nil {            return err        }    }    return nil}