ZipOutputStream写入多个文件需严格调用putNextEntry()和closeEntry()，否则仅生成空条目；中文名需UTF-8编码并用正斜杠分隔路径；须用try-with-resources确保close()写入中央目录。
ZipOutputStream 写入多个文件时为什么只生成一个空条目
因为没调用 putNextEntry() 就直接写数据，或者调用后没及时调用 closeEntry()。Zip 格式要求每个文件必须显式开启条目、写入内容、关闭条目，三步缺一不可。
常见错误现象：zipFile.zip 能打开但里面只有一个 0 字节的文件，或解压后文件名乱码、内容损坏。
- 每次写新文件前，必须先调用
zos.putNextEntry(new ZipEntry("path/in/zip.txt")) -
ZipEntry构造参数是路径名（支持子目录，如"docs/readme.md"），不是磁盘绝对路径 - 写完该文件内容后，**必须**调用
zos.closeEntry()，否则后续条目会粘连或丢失 - 不要在
putNextEntry()前写任何字节，也不要跨closeEntry()继续写
中文文件名乱码或解压后显示为“.txt”
Zip 格式本身不强制指定编码，ZipOutputStream 默认用平台默认编码（Windows 是 GBK，Linux/macOS 是 UTF-8），而多数解压工具（如 macOS 归档实用工具、Windows 资源管理器）默认按 UTF-8 解析文件名 —— 编码不一致就乱码。
解决办法不是“改系统编码”，而是统一用 UTF-8 并启用 ZIP 中文兼容标识（需 JDK 7+）：
立即学习“Java免费学习笔记（深入）”；
- 创建
ZipOutputStream时，用new ZipOutputStream(outputStream, StandardCharsets.UTF_8)构造（JDK 7+ 支持） - 确保
ZipEntry的名字是合法 UTF-8 字符串（Java String 默认就是） - 避免手动 setExtra() 或修改 DOS 时间戳字段，容易破坏兼容性
- 如果目标环境必须兼容老系统（如 Windows XP 解压工具），改用
Apache Commons Compress的ZipArchiveOutputStream并设setUseUnicodeExtraFields(true)
压缩大文件时内存溢出或卡死
ZipOutputStream 本身不缓存整个文件内容，但如果你把文件全读进 byte[] 再 write，就会 OOM。真正瓶颈常在「读取方式」和「缓冲区大小」。
- 永远用带缓冲的流读取源文件：用
Files.newInputStream(path)+BufferedInputStream，别用Files.readAllBytes() - 写入时用固定大小缓冲区（如 8192 字节），避免小块 write 拖慢速度：
byte[] buf = new byte[8192]; int len; while ((len = is.read(buf)) != -1) { zos.write(buf, 0, len); } - 对超大文件（>500MB），考虑分片压缩或改用内存映射（
MappedByteBuffer），但 ZipOutputStream 不支持随机写，所以仍需顺序流式处理
如何正确关闭 ZipOutputStream 避免损坏 ZIP 文件
ZIP 文件结尾有中央目录结构，必须由 close() 或 finish() 写入。只关底层流、不关 ZipOutputStream，会导致 ZIP 文件无法被识别为有效归档。
- 务必在所有
closeEntry()调用完成后，再调用zos.close()（推荐）或zos.finish()+ 关底层流 - 用 try-with-resources 最安全：
try (ZipOutputStream zos = new ZipOutputStream(out, StandardCharsets.UTF_8)) { for (Path file : files) { zos.putNextEntry(new ZipEntry(Paths.get(file.toString()).getFileName().toString())); Files.copy(file, zos); zos.closeEntry(); } } // ← 自动 close()，保证中央目录写入 - 不要在循环中反复 new ZipOutputStream；一个实例对应一个 ZIP 文件
"/"，哪怕在 Windows 上生成 ZIP，也不能用 "\" 或 File.separator —— 否则部分解压工具会当成非法字符或创建失败目录。 
