Java中用ZipOutputStream创建ZIP文件的核心是正确组织ZipEntry、写入内容并及时收尾：需用正斜杠路径、目录条目以/结尾且长度为0、每个putNextEntry()后必须调用closeEntry()，最后调用close()写入中央目录。
Java中用ZipOutputStream创建ZIP压缩文件，核心是把多个ZipEntry逐个写入输出流，并确保每个条目内容正确写入、流及时关闭。关键不在“怎么写”，而在于“怎么组织条目+怎么写内容+怎么收尾”。
准备一个可写的输出流
必须传入一个底层可写的字节流（如FileOutputStream），它最终承载整个ZIP文件的二进制数据。不能直接操作文件路径，必须通过流封装：
- 推荐用
try-with-resources自动管理流生命周期，避免忘记close() - 不要用
BufferedOutputStream套一层再传给ZipOutputStream——它内部已有缓冲，多套反而可能干扰校验和或导致末尾截断 - 示例：
new ZipOutputStream(new FileOutputStream("output.zip"))
为每个文件/目录添加ZipEntry
ZipEntry代表ZIP包里的一个成员（可以是文件，也可以是目录）。注意以下细节：
- 路径名必须用正斜杠
/分隔，即使在Windows上也要统一（如"src/Main.java"，不是"src\\Main.java"） - 目录条目需以
/结尾，且内容长度为0；调用putNextEntry()后要立刻closeEntry()，不能写内容 - 可设置时间戳、压缩方式（
STORED或DEFLATED）、是否加密（Java原生ZipOutputStream不支持密码加密）
写入内容并正确结束每个条目
每写一个文件，流程固定三步：创建Entry → putNextEntry → 写入字节 → closeEntry：
立即学习“Java免费学习笔记（深入）”；
-
putNextEntry()必须在写内容前调用，否则抛IllegalStateException - 写完内容后务必调用
closeEntry()——它会触发压缩、写入CRC、更新本地文件头。漏掉会导致ZIP损坏或解压失败 - 如果某个条目内容为空（比如空文件），仍需调用
putNextEntry()+closeEntry()，不能跳过
关闭流前确保所有Entry已结束
ZipOutputStream.close()不只是关流，还会写入中央目录结构。若之前有putNextEntry()但没closeEntry()，close()会尝试补救，但行为不可靠，强烈建议显式配对：
- 所有
putNextEntry()都应有对应的closeEntry() - 整个ZIP写完后调用
close()（或让try-with-resources自动完成） - 生成的ZIP若无法被系统解压器识别，大概率是
closeEntry()遗漏或路径格式错误
基本上就这些。不复杂但容易忽略细节，尤其是closeEntry()和路径分隔符。写个小工具批量压缩时，顺手加个日志打印每个entry名，能省下大半调试时间。
