zipoutputstream 中压缩包结构由 zipentry 路径名决定，需显式管理条目；每文件须严格执行 putnextentry→写入→closeentry；中文名需 utf-8 编码处理，空目录以 / 结尾，避免重复名与非法字符。
ZipOutputStream 打包多个文件时，真正决定压缩包内部结构的不是文件本身，而是每个 ZipEntry 实例所携带的路径名和元信息。它不自动读取源文件系统路径，也不校验条目是否重复或冲突——所有条目管理逻辑都由你显式控制。
ZipEntry 的名称就是解压后的相对路径
ZipEntry 构造时传入的字符串，会直接成为 ZIP 包内该文件的完整路径（含目录层级）。例如：
-
new ZipEntry("report/summary.pdf")→ 解压后生成report/summary.pdf -
new ZipEntry("img/logo.png")→ 解压后生成img/logo.png -
new ZipEntry("config/")→ 表示空目录（末尾斜杠不可省）
注意：不能含盘符（如 C:\）、不能含 ../ 等上级跳转，否则部分解压工具会拒绝处理或行为异常。
每个文件必须对应一个独立的 putNextEntry + closeEntry 周期
ZipOutputStream 不支持“批量添加”或“延迟写入”。每写一个文件，必须严格按顺序执行：
- 调用
zos.putNextEntry(entry)—— 开启新条目，同时关闭前一个（如有） - 写入该条目的全部字节内容（可用
Files.copy(file, zos)或循环read/write） - 必须调用
zos.closeEntry()—— 否则 ZIP 格式损坏，多数解压软件无法识别
遗漏 closeEntry() 是最常见导致 ZIP 打开失败的原因之一，尤其在异常分支中容易被忽略。
中文文件名与编码陷阱
ZipOutputStream 默认使用 IBM437 编码，直接传入中文名会导致乱码甚至解压失败。解决方式分两种场景：
-
本地保存 ZIP 文件：JDK 7+ 推荐改用
ZipArchiveOutputStream（来自 Apache Commons Compress），并显式设置setEncoding("UTF-8") -
HTTP 下载响应流：仍用
ZipOutputStream，但需确保条目名经 UTF-8 编码再转 IBM437 兼容形式（如用new String(name.getBytes(UTF_8), "GB2312")这类转换已过时且不可靠；更稳妥的是避免依赖默认编码，改用第三方库）
浏览器下载时，中文压缩包名还需通过 URLEncoder.encode(filename, "UTF-8") 处理 Content-Disposition 头。
空目录、重复名、特殊字符的处理原则
ZIP 规范允许空目录和同名条目（但实际解压行为因工具而异），因此需主动规避歧义：
- 空目录必须以
/结尾，且需调用putNextEntry+closeEntry（不写内容） - 避免不同文件生成相同
ZipEntry名（如都叫data.txt），否则后写入的会覆盖前一个 - 条目名中避免
\、?、*、、<code>>、|等 Windows 非法字符，即使 ZIP 能存，解压到 Windows 会失败
建议统一做一次路径标准化：替换反斜杠为正斜杠、过滤非法字符、对重名加序号后缀（如 file (1).txt）。
