最稳妥方式是直接用 zip.OpenReader 打开 ZIP 文件，它自动解析中央目录、支持 ZIP64 和跨盘符；若用 zip.NewReader 需确保 size 准确且仅适用于网络流或内存数据。
直接用 zip.OpenReader 打开 ZIP 文件最稳妥
别用 os.Open 后自己拼 zip.NewReader，容易漏掉 ZIP 中的中央目录（central directory），导致读不到文件或 File.FileInfo() 返回空。Go 标准库的 zip.OpenReader 会自动定位并解析整个 ZIP 结构，包括跨盘符、含 ZIP64 扩展的包。
常见错误现象：zip.ReadDir 返回空切片、File.DataOffset 为 0、调用 Open() 报 zip: not a valid zip file —— 大多是因为跳过了 OpenReader 直接喂裸 io.Reader 给 zip.NewReader。
-
zip.OpenReader返回的*zip.ReadCloser必须显式调用Close()，否则文件句柄泄漏 - 如果 ZIP 来自网络流或内存
[]byte，才考虑用zip.NewReader，且需确保传入的size参数准确（从stat.Size()或 HTTPContent-Length获取） - Windows 下路径分隔符是
\，但 ZIP 规范强制用/；Go 的zip.File内部已标准化，无需手动替换
遍历 ZIP 内容时优先用 Reader.File 切片而非递归扫描
zip.ReadCloser.File 是预解析好的 []*zip.File，按 ZIP 中文件顺序排列，包含所有条目（包括目录项）。它不是惰性加载，但一次性解析开销极小（只读中央目录），比边读边找快得多，也避免遗漏隐藏文件（如 macOS 的 __MACOSX/）。
使用场景：解压、校验文件列表、提取特定后缀文件（如只取 .txt）、跳过目录项做扁平化处理。
立即学习“go语言免费学习笔记（深入）”；
- 目录项的
File.IsDir()返回true，其File.Mode()包含os.ModeDir，可据此过滤 - 不要依赖
File.Name末尾是否带/判断目录——有些 ZIP 工具不规范，得用IsDir() - 若 ZIP 很大（>1GB）且只关心少数文件，可用
Reader.Open配合strings.HasPrefix做前缀查找，避免全量遍历
解压单个文件必须用 File.Open() + io.Copy，不能直接读 File.DataOffset
zip.File 不提供原始字节切片，DataOffset 只是本地文件头偏移，ZIP 支持压缩、加密、分卷等特性，直接 seek 并读会导致数据错乱或 panic。唯一安全方式是调用 File.Open() 得到 io.ReadCloser，再用 io.Copy 流式写入目标文件。
性能影响：流式解压天然支持大文件，内存占用恒定（约 32KB 缓冲区），比一次性 io.ReadAll 更可靠。
- 目标路径需提前创建父目录：
os.MkdirAll(filepath.Dir(dstPath), 0755) - 写入前检查
File.IsDir()，跳过目录项或单独os.MkdirAll - 注意
File.Mode()包含权限位，但 Windows 忽略执行位；Linux/macOS 可用os.Chmod恢复（需去掉os.ModeDir）
file, err := zipFile.Open()
if err != nil {
return err
}
defer file.Close()
dst, err := os.Create(dstPath)
if err != nil {
return err
}
defer dst.Close()
_, err = io.Copy(dst, file)
return err
中文文件名乱码？先确认 ZIP 创建时的编码，再选 golang.org/x/text/encoding
标准 ZIP 规范没有强制编码，Windows 默认用 GBK/CP936，macOS/Linux 通常用 UTF-8。Go 的 archive/zip 默认按 UTF-8 解析文件名，遇到 GBK 编码的 ZIP 就会显示为 .txt。
解决方法不是“自动检测编码”（不可靠），而是根据来源明确指定：
- 从 Windows 上传的 ZIP，大概率是 GBK → 用
encoding.RegisterCharset("gbk", gbk.NewDecoder())+ 自定义zip.File名称替换 - 用
unzip -l查看原始名称：若显示正常，说明是 UTF-8；若显示，再试unzip -O gbk - 更健壮的做法：解压前先用
zip.ReadCloser.File遍历，对每个File.Name尝试 UTF-8 解码，失败则 fallback 到 GBK（需引入golang.org/x/text/encoding/simplifiedchinese）
File.Name 是否可 utf8.DecodeRuneInString。 
