Go archive/zip FileHeader.ExternalAttrs 读取条目权限属性

读取 ZIP 条目的权限属性时，先不要把 FileHeader.ExternalAttrs 直接当成 Unix 权限整数。这个字段是一个 uint32，官方文档明确说明它的含义取决于 CreatorVersion。更稳妥的做法是保留原始值用于审计，再调用 FileHeader.Mode() 得到 Go 的 fs.FileMode，最后根据创建者平台判断能否继续恢复权限。

ExternalAttrs 不是通用权限整数，先保留原始值

FileHeader 描述 ZIP 中的单个条目，ExternalAttrs 位于中央目录的外部属性区域。它的编码方式由创建 ZIP 的工具和平台决定，所以同一个数值不能脱离上下文直接解释为“用户、组、其他”的权限位。CreatorVersion 至少要和它一起记录。

还要把它和 Method 区分开：Method 表示 Store 或 Deflate 等压缩方法，ExternalAttrs 讨论的是条目属性；它们互不替代。

遍历 ZIP 条目时同时读取 CreatorVersion 和 ExternalAttrs

读取阶段可以把原始字段保存到自己的记录结构中，然后再调用 Mode()。下面的示例只展示元数据读取，不会把权限直接写回磁盘：

package main

import (
    "archive/zip"
    "fmt"
    "io/fs"
    "log"
)

type EntryMeta struct {
    Name          string
    Creator       uint16
    ExternalAttrs uint32
    Mode          fs.FileMode
}

func main() {
    // 打开 ZIP 并确保底层文件在遍历结束后关闭。
    reader, err := zip.OpenReader("assets.zip")
    if err != nil {
        log.Fatal(err)
    }
    defer reader.Close()

    for _, file := range reader.File {
        // 保存原始值，后续审计时仍能追溯 ZIP 中的字段。
        meta := EntryMeta{
            Name:          file.Name,
            Creator:       file.CreatorVersion,
            ExternalAttrs: file.ExternalAttrs,
            Mode:          file.Mode(),
        }
        fmt.Printf("%s creator=%#x external=%#x mode=%s\\n",
            meta.Name, meta.Creator, meta.ExternalAttrs, meta.Mode)
    }
}

这里的关键不是打印出一个漂亮的八进制数，而是保留三组信息：条目名称、创建者版本、原始外部属性。只有这样，后续发现某个压缩工具采用不同编码时，才有机会重新解释历史数据。

用 Mode() 读取权限模式，再处理目录和符号链接边界

FileHeader.Mode() 返回 fs.FileMode，由标准库按照 ZIP 条目的属性推导模式位。它适合做“这是普通文件、目录还是特殊类型”的第一层判断，也适合在导出报告中显示模式；但它不承诺把所有压缩工具的私有扩展还原成一致的操作系统权限。

func describeMode(file *zip.File) string {
    mode := file.Mode()

    // 先判断类型位，再显示权限；目录不要按普通文件处理。
    switch {
    case mode.IsDir():
        return "directory: " + mode.String()
    case mode&fs.ModeSymlink != 0:
        return "symlink: " + mode.String()
    default:
        return "regular: " + mode.String()
    }
}

如果程序只是做清单展示，保留 mode.String() 和原始字段即可。如果程序要在目标系统创建文件，则应另外制定权限映射策略：先判断目标平台，再决定是否只使用读写执行位；不要因为看到 0777 样式的结果就直接信任并落盘。

导入程序的字段检查清单

实际导入时，权限只是一个信号。路径安全、重复条目、符号链接策略和目标目录权限同样重要。尤其不要把“能够读到 ExternalAttrs”误认为“可以安全恢复原权限”。

相关问题

为什么 ExternalAttrs 读出来是零？

可能是创建工具没有写入外部属性，也可能是该条目采用的属性编码不包含你关心的权限信息。保留 CreatorVersion、ExternalAttrs 和 Mode() 结果，再决定是否需要兼容特定工具。

Mode() 和 ExternalAttrs 应该选哪一个？

做 Go 程序内的类型判断或报告时优先使用 Mode()；做原始归档审计或兼容未知工具时两者都保存。前者是解释结果，后者是原始证据。

读取权限属性后能直接 chmod 吗？

不建议。先确认创建者平台、目标平台、路径安全和业务策略，再把允许的模式位映射到目标系统；不确定时宁可采用受限默认权限。