Go zip.Writer CreateHeader 的权限信息保留方法

使用 Go 的 zip.Writer.CreateHeader 保留普通文件权限，最直接的写法是先用 zip.FileInfoHeader(info) 构建文件头，再设置归档内名称、压缩方法并创建条目。手动构造文件头时则调用 SetMode。仅调用 Create(name) 或只填写 Name，不能把源文件权限自动带进 ZIP。

官方地址：https://pkg.go.dev/archive/zip

从 FileInfo 生成带权限的文件头

先明确一个场景：把用于部署的普通文件打包，希望记录它原本的可执行位。权限来自实际文件的 FileInfo，而不是从扩展名猜测。FileInfoHeader 会把模式放进文件头；它只根据基本名填写 Name，若归档需要目录层级，应另外设置相对路径，例如 bin/worker。ZIP 内名称使用正斜线，不写绝对路径或盘符。

下方函数是单文件打包写法；它打开源文件后从同一文件句柄取得元数据，拒绝目录和特殊文件。它读取的是打开后所指向的普通文件，并不保存符号链接本身；需要符号链接归档时不能套用这段函数。

package zipmode

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

// PackRegular 把一个普通文件写入单条目的 ZIP。
// dst 由调用方关闭；本函数负责关闭源文件和 ZIP 写入器。
func PackRegular(dst io.Writer, source string) (err error) {
    src, err := os.Open(source)
    if err != nil { return fmt.Errorf("打开源文件: %w", err) }
    defer func() {
        if closeErr := src.Close(); err == nil { err = closeErr }
    }()
    info, err := src.Stat()
    if err != nil { return err }
    if !info.Mode().IsRegular() {
        return fmt.Errorf("只接受普通文件")
    }
    // FileInfoHeader 已调用 SetMode；Name 在此仅保留文件基本名。
    h, err := zip.FileInfoHeader(info)
    if err != nil { return err }
    h.Method = zip.Deflate
    zw := zip.NewWriter(dst)
    defer func() {
        // Close 写出中央目录；错误必须交给调用方。
        if closeErr := zw.Close(); err == nil { err = closeErr }
    }()
    entry, err := zw.CreateHeader(h)
    if err != nil { return err }
    // CreateHeader 后不再修改 h，也不并发写其他条目。
    if _, err = io.Copy(entry, src); err != nil { return err }
    return nil
}

这是已有标准库接口的使用方式，不涉及某次新提案或版本行为变更。FileInfoHeader 的 Method 默认未设压缩方法，想压缩应显式指定 Deflate。不要因为 CreateHeader 接受了文件头，就省略源文件的读取和条目内容写入。

说明权限元数据的存放位置

在 Go 当前实现中，SetMode 同时设置 CreatorVersion 的平台标识与 ExternalAttrs 的模式属性，使权限与平台解释方式相匹配。FileInfoHeader 已经调用 SetMode，因此通常不必再手工修改这两个底层字段。Mode 则负责把头信息读回 Go 的 FileMode。

不要直接把 0755 填入 ExternalAttrs 就认为完成了权限设置：这个字段包含 ZIP 格式下的属性布局，平台标识也参与解释。手动创建条目时使用公开方法更清楚：

// 用明确的发布策略创建文件头；0755 是示例策略，不是任意文件的默认权限。
h := &zip.FileHeader{Name: "bin/worker", Method: zip.Deflate}
h.SetMode(0755)
// 必须在 CreateHeader 之前设置完模式；之后不再更改这个文件头。

写入完整归档并处理关闭错误

权限头和文件内容是两个部分。上面的代码由 io.Copy 写入条目内容，由 Writer.Close 写出中央目录；仅成功复制文件内容还不足以宣告 ZIP 已完成。函数采用具名错误返回，在没有更早错误时把关闭错误返回给调用方。

Writer.Close 不会替调用方关闭底层 dst。如果 dst 是通过 os.Create 打开的目标文件，调用方仍须检查该文件的 Close 错误。发生复制或关闭错误时，输出可能只是部分归档，业务上不应当把它作为成功产物交付。生产程序可先写临时文件，完整结束后再发布产物。

每次创建条目前都准备一个独立的 FileHeader，设置完整后再传给 CreateHeader；不要把同一个头反复改名后并发用于多个条目，也不要在条目写入期间回头改权限。所有权和写入顺序应当由一个明确的归档函数管理。

划清目录与跨平台恢复范围

目录条目的名称应以 / 结束，并带有目录模式。手动目录头可以这样表达，目录条目不写普通文件内容：

// 目录类型使用 Go 的 ModeDir，不要混入其他平台的文件类型数值。
dir := &zip.FileHeader{Name: "bin/", Method: zip.Store}
dir.SetMode(os.ModeDir | 0755)
// 将 dir 交给 CreateHeader，并处理它返回的错误。

把权限写进 ZIP，只说明归档保存了相关元数据。解压工具是否采用这些属性、目标文件系统是否支持、创建文件时受到哪些本地规则影响，是另一层问题。若自己实现 Go 解压器，应明确读取 FileHeader.Mode 并根据目标平台的权限策略应用；打开条目内容不会自动创建目标文件，更不会自动 chmod。

本例的权限保留范围不是完整文件系统备份。Unix 用户组、所有者、ACL、扩展属性以及平台专有权限，不能仅凭 SetMode 就视为完整保存。跨平台分发时应把“保留可执行位”与“复制全部安全元数据”分开约定。

选择权限保留或统一发布策略

如果源文件恰好带有不希望分发的权限，原样保留并非唯一合理选择。部署包可以明确约定普通文档为 0644、可执行文件为 0755，再用 SetMode 统一记录。需要保留原貌时不要不加说明地调用 Perm 后丢弃其他模式位；需要缩小权限范围时则把这作为发布策略明示。

压缩方法会改变可执行位吗？

Method 控制条目内容的压缩方式，权限属于文件头属性，两者分别配置。改用 Deflate 不能补回没有记录的模式。

为什么读取头信息正确，解压后仍不同？

归档记录与目标文件权限是两个结果。先区分解压工具的恢复策略与目标系统能力，不能只凭打包端写了 SetMode 就推断落盘权限完全一致。

能直接用这个函数打包整个目录吗？

不能。该函数刻意只接受一个普通文件；目录遍历还需要相对名称映射、目录头和不同文件类型的处理策略。

技术资料：Go archive/zip 文档；FileHeader 模式实现。