Java中用ZipOutputStream压缩多文件需逐个创建ZipEntry并写入内容，注意相对路径、UTF-8中文名支持、空目录手动添加及流正确关闭。
Java 中使用 ZipOutputStream 压缩多个文件，核心是逐个创建 ZipEntry 并写入对应文件内容，注意路径处理、流关闭顺序和中文文件名兼容性。
准备文件列表并创建 ZIP 输出流
先准备好要压缩的文件（或目录），用 FileOutputStream 包装 ZipOutputStream。推荐使用 try-with-resources 自动管理资源：
- 确保目标 ZIP 文件路径可写，父目录已存在
- 若需支持中文文件名，建议使用
new ZipOutputStream(new FileOutputStream(...), StandardCharsets.UTF_8)（Java 7+） - 避免直接用
File构造绝对路径的ZipEntry，应提取相对路径防止 ZIP 包含盘符或根目录
为每个文件创建 ZipEntry 并写入内容
对每个待压缩文件：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 计算其在 ZIP 中的相对路径（如
"docs/readme.txt"），用该路径构造ZipEntry - 调用
zipOut.putNextEntry(entry)开启新条目 - 用普通字节流（如
Files.newInputStream()或FileInputStream）读取源文件，写入ZipOutputStream - 调用
zipOut.closeEntry()结束当前条目（不可省略）
示例关键片段：
ZipEntry entry = new ZipEntry("subdir/" + file.getName());
zipOut.putNextEntry(entry);
Files.copy(file.toPath(), zipOut);
zipOut.closeEntry();
处理子目录和空文件夹
ZipOutputStream 不自动包含空目录。如需保留目录结构：
立即学习“Java免费学习笔记（深入）”；
- 对每个目录（包括空目录），手动创建以
/结尾的ZipEntry（如"images/"） - 调用
putNextEntry和closeEntry，不写入任何数据 - 遍历文件时可用
Files.walk()或递归File.listFiles()获取所有文件和目录
常见问题与注意事项
实际使用中容易踩坑：
-
流未正确关闭：必须确保
ZipOutputStream最后被关闭，否则 ZIP 文件可能损坏或不完整 -
重复调用 putNextEntry：未调用
closeEntry()就写下一个条目，会抛IllegalStateException -
时间戳问题：默认
ZipEntry时间为“now”，可调用entry.setTime(file.lastModified())保留原始修改时间 - 大文件内存占用：不要一次性读入整个文件到内存，用固定缓冲区（如 8KB）分块读写
