Go archive/zip 怎样保留文件权限

用 Go 创建 ZIP 时，如果直接调用 Writer.Create，得到的是一个能正常解压的文件条目，但权限信息没有成为你明确控制的写入步骤。需要保留 Linux 下的可执行位、目录类型或只读语义时，应先用 zip.FileInfoHeader 从 fs.FileInfo 生成头部，再通过 CreateHeader 写入。这个组合会把模式写进 ZIP 头部；读取端可用 FileHeader.Mode() 复核。

先区分文件内容、模式和解压行为

文件内容是字节流，权限则属于条目元数据。比如脚本 deploy.sh 的 0755 中，执行位并不在脚本文本里；目录还需要目录类型位，不能只把它当作一个空文件名。Go 的 archive/zip 将这些信息放在 FileHeader 中：SetMode 负责写入权限和模式位，Mode 负责读取。

因此正确的目标不是“给 ZIP 文件设置 chmod”，而是“给每个 ZIP 条目生成正确的 FileHeader”。此外，ZIP 阅读器可能只恢复普通读写位，Windows 等环境也未必采用 Unix 模式；文章中的保留指的是归档元数据被写入，而不是承诺所有解压器都会完全恢复。

用 FileInfoHeader 把权限写进 FileHeader

最小实现是打开源文件，取得 os.FileInfo，用 FileInfoHeader 复制它的大小、修改时间和模式，然后把名称改成归档内的相对路径。需要压缩时显式设置 Method = zip.Deflate，最后使用 CreateHeader。

package main

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

func addFile(w *zip.Writer, sourcePath, archiveName string) error {
	// 打开源文件以同时读取内容和 FileInfo；归档名不能直接暴露本地绝对路径。
	src, err := os.Open(sourcePath)
	if err != nil {
		return err
	}
	defer src.Close()

	info, err := src.Stat()
	if err != nil {
		return err
	}
	header, err := zip.FileInfoHeader(info)
	if err != nil {
		return err
	}
	header.Name = archiveName // 只使用相对路径，例如 bin/deploy.sh。
	header.Method = zip.Deflate // FileInfoHeader 默认不主动选择压缩方法。

	dst, err := w.CreateHeader(header)
	if err != nil {
		return err
	}
	_, err = io.Copy(dst, src) // 内容写入后，权限仍由 header 的模式元数据表达。
	return err
}

func main() {
	// 创建归档文件；Close 会写入中央目录，错误不能忽略。
	out, err := os.Create("release.zip")
	if err != nil {
		panic(err)
	}
	defer out.Close()

	w := zip.NewWriter(out)
	if err := addFile(w, "./deploy.sh", "bin/deploy.sh"); err != nil {
		panic(err)
	}
	if err := w.Close(); err != nil {
		panic(err)
	}
	fmt.Println("archive entry written")
}

这里有两个容易遗漏的点。第一，FileInfoHeader 返回的 Name 只有源文件的基础名，所以要按归档目录重新赋值。第二，archiveName 应由应用自己的相对路径规则生成，不能把用户上传的绝对路径或带 .. 的路径原样写入。

把模式、路径和收尾错误放进清单

如果只是把一个内存字符串写入 ZIP，确实可以直接 Create；但它适合“不关心来源文件模式”的场景。只要需求中出现“保留权限”“保持可执行”或“还原目录结构”，就应切换到显式头部写法。ZIP 的 ExternalAttrs 会承载由 SetMode 转换出的属性，应用代码不应手工拼装这些底层字段。

读取时复核 Mode，并把路径安全放在前面

写入成功不代表恢复过程安全。读取归档时先检查条目名称是否为本地相对路径，再读取 Mode()。Go 文档也提示，非本地名称、反斜线或路径越界可能触发 ErrInsecurePath；解压到磁盘时仍应使用自己的目标目录约束。

func inspectArchive(path string) error {
	// OpenReader 负责打开 ZIP；读取结束必须关闭文件句柄。
	r, err := zip.OpenReader(path)
	if err != nil {
		return err
	}
	defer r.Close()

	for _, entry := range r.File {
		// Name 来自归档，先拒绝绝对路径和目录穿越，再处理权限。
		if entry.Name == "" || entry.Name[0] == '/' || entry.Name == ".." {
			return fmt.Errorf("拒绝不安全归档路径: %q", entry.Name)
		}
		mode := entry.Mode()
		fmt.Printf("%s mode=%s dir=%t executable=%t\\n", entry.Name, mode.Perm(), mode.IsDir(), mode&0111 != 0)
	}
	return nil
}

示例只展示元数据检查，不负责自动解压。真正落盘时还要用 filepath.Join 后检查结果仍位于目标目录内，并按产品策略决定是否恢复执行位。对于来自不可信来源的 ZIP，权限检查和路径检查都应先于创建目标文件。

常见问题

为什么用 zip.Writer.Create 后权限变成默认值

Create 只接收归档名并创建默认头部，不知道源文件的 os.FileMode。需要保留权限时改用 FileInfoHeader + CreateHeader。

FileInfoHeader 会不会保存文件属主和 ACL

不会。它主要复制文件信息中的模式、时间和大小等 ZIP 头部可表达内容；属主、扩展 ACL、扩展属性需要额外的归档协议或外部清单。

只设置 header.SetMode 就够了吗

还不够。模式只解决条目元数据，仍要设置安全的相对 Name、写入内容并检查 Writer.Close。解压侧也不能默认信任归档路径和权限。

归档权限的核心链路可以概括为：源文件的 FileInfo.Mode() → FileInfoHeader → FileHeader.SetMode → CreateHeader。把这条链路和相对路径、关闭错误一起固化在代码里，ZIP 才既保留了需要的元数据，又不会把本地路径和不安全权限意外带入发布流程。