Java中用ZipOutputStream打包多个文件的核心是逐个写入ZipEntry并写入对应文件内容，需注意路径处理（转Unix风格、去绝对路径）、设置UTF-8编码防乱码、用try-with-resources确保流关闭、目录以/结尾、大文件用缓冲读写、保留原始时间戳等细节。
Java 中用 ZipOutputStream 打包多个文件，核心是逐个写入条目（ZipEntry），再把对应文件内容写入流中。关键在于路径处理、资源释放和异常控制，否则容易出现空目录、乱码或流未关闭问题。
准备 ZipOutputStream 和基础结构
先创建一个 FileOutputStream 指向目标 ZIP 文件，再包装成 ZipOutputStream。建议使用 try-with-resources 自动关闭：
- 设置编码（如需中文路径）：调用
setEncoding("UTF-8")，否则 Windows 下可能解压乱码 - 避免直接传绝对路径：提取相对路径作为 entry 名称，否则压缩包里会出现完整盘符（如
C:.txt） - 不要手动 flush()：写完每个 entry 后，
closeEntry()才是必须的，它会完成当前条目的写入
逐个添加文件并写入内容
对每个待压缩文件，创建 ZipEntry，注意其名称必须是正斜杠分隔的 Unix 风格路径（如 "docs/readme.txt"），不能含驱动器名或反斜杠：
- 如果是文件：用
new ZipEntry(relPath)，然后用Files.copy(file.toPath(), zipOut)或传统字节数组循环写入 - 如果是目录：创建一个以
/结尾的ZipEntry（如"images/"），调用putNextEntry()后立即closeEntry()，无需写内容 - 推荐用
Files.walk()遍历源目录，跳过自身 ZIP 文件，统一计算相对路径
处理常见陷阱
实际开发中容易踩坑的地方：
立即学习“Java免费学习笔记（深入）”；
-
时间戳问题：默认 entry 时间为打包时刻，若需保留原始修改时间，可调用
entry.setTime(file.lastModified()) - 大文件内存风险：别一次性读整个文件到内存，用 8KB 缓冲区循环读写更安全
- 重复 entry 名称：同名文件会被后写入的覆盖，建议提前校验或自动重命名
-
符号链接：
Files.isSymbolicLink()判断，通常跳过或按普通文件处理（取决于需求）
完整示例片段（不依赖第三方库）
以下是一个最小可行逻辑（省略异常处理细节）：
try (FileOutputStream fos = new FileOutputStream("output.zip");
ZipOutputStream zos = new ZipOutputStream(fos)) {
zos.setEncoding("UTF-8");
Path srcDir = Paths.get("src");
Files.walk(srcDir)
.filter(Files::isRegularFile)
.forEach(filePath -> {
String relPath = srcDir.relativize(filePath).toString().replace("\", "/");
try (InputStream is = Files.newInputStream(filePath)) {
zos.putNextEntry(new ZipEntry(relPath));
is.transferTo(zos); // Java 9+ 推荐方式
zos.closeEntry();
} catch (IOException e) {
throw new UncheckedIOException(e);
}
});
}
不复杂但容易忽略细节，做好路径、编码和资源管理，就能稳定生成标准 ZIP 包。
